Home Assistant MCP (ha-mcp)

Context cost warning: its tools/list is about 60,203 tokens (77 tools), 184% of a 32k context window and 30% of a 200k window, before you send a single message. Load only the tools you need, or expect most of the context to go to tool definitions. Estimate from our testing of the tool names, descriptions and input schemas, counted with cl100k_base, measured 2026-11-18 UTC. How MCP context cost adds up

90/100

Capped at 90: 4 of 5 real tool calls passed in our test; the tests add up to 95. Why scores are capped

Last tested 2026-11-18 UTC (Fresh: tested within 30 days) Working (tool call tested 2026-11-18 UTC) Needs your own Home Assistant access token

Advisories: not yet checked

Security review: not tested

Test points add up to 95; the score is capped at 90 because not every real tool call passed. Not a quality or security rating. Why scores are capped

Test points before the cap (95/100)

  • Install20/20
  • Handshake30/30
  • Maintenance25/25
  • Docs10/15
  • License10/10

Tested against the project's own public demo instance, not a real home: Home Assistant MCP (PyPI ha-mcp 9.2.0, MIT; repo homeassistant-ai/ha-mcp, 7,959 GitHub stars when tested) needs HOMEASSISTANT_URL and HOMEASSISTANT_TOKEN, so our standard no-credentials handshake exits. The project's install script (https://github.com/homeassistant-ai/ha-mcp/blob/master/scripts/install.sh) publishes a demo login for its public demo server (https://ha-mcp-demo-server.qc-h.net); we used that login (token not stored or shown) for tool listing and read-only calls only, with no writes or state changes. Initialize and tools/list over stdio listed 77 tools (32 annotated read-only, 45 destructive). Real calls: ha_get_overview returned 143 entities in 41 domains (Home Assistant 2026.6.4), ha_list_floors_areas returned 2 floors and 7 areas, ha_config_list_helpers input_boolean returned 1 helper, ha_get_state sun.sun returned its state. ha_config_list_helpers with helper_type 'all' failed with COMPONENT_NOT_INSTALLED (needs the ha_mcp_tools custom component, not installed on the demo). Write tools not called.
Tool-call test (2026-11-18 UTC, direct MCP stdio client, no LLM): partial. 4 of 5 read-only calls passed on the public demo instance; helper_type 'all' needs a custom component the demo lacks. No write tools called. Evidence: local test run, Nov 18, 2026 UTC, live endpoint probe, Nov 17, 2026 UTC.

Transport (tested 2026-11-18 UTC): stdio

Token cost (estimate): approx. 60203 tokens, cl100k estimate (77 tools, measured 2026-11-18 UTC, version 9.2.0). This is an estimate from our testing of the tool names, descriptions and input schemas, counted with cl100k_base.

Permissions: 24 read, 44 write (state-changing), 9 unclassified · Auth: API key · Rate limit: unknown · Pricing unit: unknown

Auth: API key. Rate limit: unknown. Pricing unit: unknown.

  • ha_bulk_control — unclassified
  • ha_call_event — unclassified
  • ha_call_service — unclassified
  • ha_config_delete_dashboard — write (state-changing)
  • ha_config_delete_dashboard_resource — write (state-changing)
  • ha_config_get_automation — read
  • ha_config_get_calendar_events — write (state-changing)
  • ha_config_get_category — write (state-changing)
  • ha_config_get_dashboard — read
  • ha_config_get_label — write (state-changing)
  • ha_config_get_scene — write (state-changing)
  • ha_config_get_script — read
  • ha_config_list_dashboard_resources — write (state-changing)
  • ha_config_list_groups — read
  • ha_config_list_helpers — read
  • ha_config_remove_automation — write (state-changing)
  • ha_config_remove_calendar_event — write (state-changing)
  • ha_config_remove_category — write (state-changing)
  • ha_config_remove_group — write (state-changing)
  • ha_config_remove_label — write (state-changing)
  • ha_config_remove_scene — write (state-changing)
  • ha_config_remove_script — write (state-changing)
  • ha_config_set_automation — write (state-changing)
  • ha_config_set_calendar_event — write (state-changing)
  • ha_config_set_category — write (state-changing)
  • ha_config_set_dashboard — write (state-changing)
  • ha_config_set_dashboard_resource — write (state-changing)
  • ha_config_set_group — write (state-changing)
  • ha_config_set_helper — write (state-changing)
  • ha_config_set_label — write (state-changing)
  • ha_config_set_scene — write (state-changing)
  • ha_config_set_script — write (state-changing)
  • ha_eval_template — unclassified
  • ha_get_app — read
  • ha_get_automation_traces — read
  • ha_get_camera_image — read
  • ha_get_device — read
  • ha_get_entity — read
  • ha_get_entity_exposure — read
  • ha_get_hacs_info — read
  • ha_get_history — read
  • ha_get_integration — read
  • ha_get_logs — read
  • ha_get_operation_status — read
  • ha_get_overview — write (state-changing)
  • ha_get_skill_guide — read
  • ha_get_state — read
  • ha_get_system_health — read
  • ha_get_todo — read
  • ha_get_zone — read
  • ha_list_floors_areas — read
  • ha_list_services — read
  • ha_manage_app — write (state-changing)
  • ha_manage_backup — unclassified
  • ha_manage_blueprints — write (state-changing)
  • ha_manage_energy_prefs — write (state-changing)
  • ha_manage_hacs — write (state-changing)
  • ha_manage_pipeline — write (state-changing)
  • ha_manage_radio — write (state-changing)
  • ha_manage_theme — unclassified
  • ha_manage_updates — unclassified
  • ha_reload_core — unclassified
  • ha_remove_area_or_floor — write (state-changing)
  • ha_remove_device — write (state-changing)
  • ha_remove_entity — write (state-changing)
  • ha_remove_helpers_integrations — write (state-changing)
  • ha_remove_todo_item — write (state-changing)
  • ha_remove_zone — write (state-changing)
  • ha_report_issue — unclassified
  • ha_restart — write (state-changing)
  • ha_search — read
  • ha_set_area_or_floor — write (state-changing)
  • ha_set_device — write (state-changing)
  • ha_set_entity — write (state-changing)
  • ha_set_integration — write (state-changing)
  • ha_set_todo_item — write (state-changing)
  • ha_set_zone — write (state-changing)

tested against the project's public demo with its published demo login; without credentials the server exits; your own instance needs a token (HOMEASSISTANT_URL, HOMEASSISTANT_TOKEN)

Score 90/100 · Tools 77 · Token cost approx. 60,203 tokens · Compare · Last tested 2026-11-18 UTC · Version tested 9.2.0 · Package ha-mcp · Repo homeassistant-ai/ha-mcp

Summary: Home Assistant MCP (ha-mcp) completed an MCP handshake against the project's public demo with the project's published demo login and listed 77 tools; without credentials the handshake exits, and your own instance needs a token.

Evidence summary

Handshake
pass
Tools listed
77
Context cost
approx. 60203 tokens, cl100k estimate (77 tools, measured 2026-11-18 UTC, version 9.2.0; an estimate) ranking · add up your servers' context cost
API key
Needs your own Home Assistant access token
Tested
2026-11-18 UTC

Test results

TestResultPointsEvidence
installpass20uv pip install ha-mcp (Python venv, Linux) succeeded in 0s.
handshakepass30MCP initialize + tools/list over stdio succeeded against the project's public demo server, using the demo login the project publishes; 77 tools listed in 4.7s. Without credentials the server exits.
maintenancepass25Repo pushed 0 days before test; 7,959 GitHub stars.
docspartial10README over 3,000 chars; install instructions present. Check of the package's own README (PyPI long_description (package README)).
licensepass10MIT (OSI-approved).

Local-model readiness

Token cost (estimate): approx. 60203 tokens, cl100k estimate for 77 tools · about 735% of an 8k context. This is an estimate from our testing (counted with cl100k_base).

Small-model friendly (schema heuristic, not a model result): unknown.

Not tested

Small-model task runs: Not yet tested.

What we tested and what we didn't

Tested on 2026-11-18 UTC

  • Install from the registry
  • We connected to the project's public demo server with the demo login the project publishes and asked for its tool list: it listed 77 tools (Method details: MCP initialize then tools/list)
  • Maintenance signals (last push, archived/deprecated status)
  • Docs (README length, install and config example)
  • License (OSI-approved or not)
  • Token cost (estimate)

Not tested

  • Security: not audited (no code review, no permission or data-flow analysis)
  • Real tasks (no functional task runs yet)
  • Behaviour with real credentials or a real account
  • Performance, rate limits or load
  • Correctness of results beyond the listed tasks

Methodology: how we test. A high score means it installs and responds, not that giving it access to your data carries no risk.

Known security issues

Not yet checked.

Monthly roundup: MCP security issues, October 2026.

Tool list changes

Baseline recorded from the 2026-11-18 UTC test run; changes appear after the next test.

Snapshot hash (fingerprint of the tool list)

d8c34764ee0e: SHA-256 of the canonical tool names, descriptions and input schemas. If it changes, the tool list changed.

Feeds: RSS · JSON.

Raw test record (JSON)
{
  "name": "ha-mcp",
  "version": "9.2.0",
  "registry": "pypi",
  "status": "working",
  "tested": "2026-11-18",
  "tools_count": 77,
  "deprecated": false,
  "archived": false,
  "tests": {
    "install": [
      "pass",
      20,
      "`uv pip install ha-mcp` (Python venv, Linux) succeeded in 0s."
    ],
    "handshake": [
      "pass",
      30,
      "MCP `initialize` + `tools/list` over stdio succeeded against the project's public demo server, using the demo login the project publishes; 77 tools listed in 4.7s. Without credentials the server exits."
    ],
    "maintenance": [
      "pass",
      25,
      "Repo pushed 0 days before test; 7,959 GitHub stars."
    ],
    "docs": [
      "partial",
      10,
      "README over 3,000 chars; install instructions present. Check of the package's own README (PyPI long_description (package README))."
    ],
    "license": [
      "pass",
      10,
      "MIT (OSI-approved)."
    ]
  },
  "testedAt": "2026-11-18T03:44:57.250Z"
}

Install

uvx ha-mcp

Pin the version we tested

uvx ha-mcp==9.2.0

pip install ha-mcp==9.2.0

tested 2026-11-18 UTC. Newer versions may differ and were not tested by us.

{
  "mcpServers": {
    "home-assistant-mcp-ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp==9.2.0"
      ],
      "env": {
        "HOMEASSISTANT_URL": "<your Home Assistant URL>",
        "HOMEASSISTANT_TOKEN": "<your long-lived access token>"
      }
    }
  }
}

Tools listed

Showing 40 of 77 names: ha_get_app, ha_manage_app, ha_list_floors_areas, ha_remove_area_or_floor, ha_set_area_or_floor, ha_manage_pipeline, ha_manage_blueprints, ha_report_issue, ha_config_get_calendar_events, ha_config_remove_calendar_event, ha_config_set_calendar_event, ha_get_camera_image, ha_config_get_category, ha_config_remove_category, ha_config_set_category, ha_config_get_automation, ha_config_remove_automation, ha_config_set_automation, ha_config_delete_dashboard, ha_config_get_dashboard, ha_config_set_dashboard, ha_config_list_helpers, ha_config_set_helper, ha_config_get_scene, ha_config_remove_scene, ha_config_set_scene, ha_config_get_script, ha_config_remove_script, ha_config_set_script, ha_manage_energy_prefs, ha_get_entity, ha_remove_entity, ha_set_entity, ha_config_list_groups, ha_config_remove_group, ha_config_set_group, ha_get_hacs_info, ha_manage_hacs, ha_get_history, ha_get_integration.

Show all 77 names

ha_get_app, ha_manage_app, ha_list_floors_areas, ha_remove_area_or_floor, ha_set_area_or_floor, ha_manage_pipeline, ha_manage_blueprints, ha_report_issue, ha_config_get_calendar_events, ha_config_remove_calendar_event, ha_config_set_calendar_event, ha_get_camera_image, ha_config_get_category, ha_config_remove_category, ha_config_set_category, ha_config_get_automation, ha_config_remove_automation, ha_config_set_automation, ha_config_delete_dashboard, ha_config_get_dashboard, ha_config_set_dashboard, ha_config_list_helpers, ha_config_set_helper, ha_config_get_scene, ha_config_remove_scene, ha_config_set_scene, ha_config_get_script, ha_config_remove_script, ha_config_set_script, ha_manage_energy_prefs, ha_get_entity, ha_remove_entity, ha_set_entity, ha_config_list_groups, ha_config_remove_group, ha_config_set_group, ha_get_hacs_info, ha_manage_hacs, ha_get_history, ha_get_integration, ha_remove_helpers_integrations, ha_set_integration, ha_config_get_label, ha_config_remove_label, ha_config_set_label, ha_get_logs, ha_manage_radio, ha_get_device, ha_remove_device, ha_set_device, ha_config_delete_dashboard_resource, ha_config_list_dashboard_resources, ha_config_set_dashboard_resource, ha_get_overview, ha_get_state, ha_search, ha_bulk_control, ha_call_event, ha_call_service, ha_get_operation_status, ha_list_services, ha_get_system_health, ha_reload_core, ha_restart, ha_manage_theme, ha_get_todo, ha_remove_todo_item, ha_set_todo_item, ha_get_automation_traces, ha_manage_updates, ha_eval_template, ha_get_entity_exposure, ha_get_zone, ha_remove_zone, ha_set_zone, ha_manage_backup, ha_get_skill_guide

Quick config

{
  "mcpServers": {
    "home-assistant-mcp-ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ],
      "env": {
        "HOMEASSISTANT_URL": "<your Home Assistant URL>",
        "HOMEASSISTANT_TOKEN": "<your long-lived access token>"
      }
    }
  }
}

API key: set HOMEASSISTANT_URL and HOMEASSISTANT_TOKEN in env (replace <your Home Assistant URL> and <your long-lived access token>). We tested against the project's public demo server with its published demo login; your own Home Assistant instance needs its own access token.

Add to config Opens the config generator with this server selected.

Setup

Env vars required for real use (per its README): HOMEASSISTANT_URL, HOMEASSISTANT_TOKEN

  1. Install. Run uv pip install ha-mcp (Python venv). This is the exact command we ran on 2026-11-18 UTC.
  2. Configure. Add the mcpServers entry below to your MCP client config and set HOMEASSISTANT_URL, HOMEASSISTANT_TOKEN.
  3. Verify. Restart the client and check that tools/list returns tools (77 in our test).
{
  "mcpServers": {
    "home-assistant-mcp-ha-mcp": {
      "command": "uvx",
      "args": [
        "ha-mcp"
      ],
      "env": {
        "HOMEASSISTANT_URL": "<your Home Assistant URL>",
        "HOMEASSISTANT_TOKEN": "<your long-lived access token>"
      }
    }
  }
}

Test history

Follow this server (RSS) · Monthly changelog

FAQ

Is Home Assistant MCP (ha-mcp) deprecated?

No. Home Assistant MCP (ha-mcp) was not deprecated or archived when we last tested it on 2026-11-18 UTC.

What replaces Home Assistant MCP (ha-mcp)?

Nothing; Home Assistant MCP (ha-mcp) is not deprecated as of 2026-11-18 UTC.

Does Home Assistant MCP (ha-mcp) need an API key?

Yes, for your own home. We tested it against the project's public demo server with the demo login the project publishes, where it listed 77 tools and 4 of 5 read-only calls passed. Without credentials the server exits; your own Home Assistant instance needs its own URL and access token (HOMEASSISTANT_URL and HOMEASSISTANT_TOKEN).

Embed the badge

TestedMCP: 90/100, tested 2026-11-18 UTC

Every tested server gets a free embeddable badge. It shows the current score and test date and expires after 90 days. Testing is free; payment never changes a score.

Claim this listing · Report an issue