ha-mcp-dev
Home Assistant MCP Server - Complete control of Home Assistant through MCP
Decision gist · record as of 2026-08-14
Yes, if you use Home Assistant and want AI assistants to control your smart home. The custom component install is straightforward, maintenance is active, and there are no known vulnerabilities. The dev version tag suggests this is a pre-release; verify stability for your use case before production deployment. MIT license is permissive.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.13 or 3.14; requires a running Home Assistant instance and a long-lived access token or webhook URL to connect.
- Low friction install as a pure Python wheel.
- Active maintenance with a recent release and 4381 GitHub stars.
License · maintenance · safety
MIT (permissive) — MIT license (permissive) — you can use, modify, and distribute this package freely with minimal restrictions.
last release 2026-08-14 (0 days) · last repo commit 2026-08-14 · 4,381 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 146,293 downloads/mo, #11,100 on PyPI
Alternatives
Verify before relying
pip install ha-mcp-dev
import ha_mcp
# Configure via environment variables (HOMEASSISTANT_URL, HOMEASSISTANT_TOKEN)
# or use the Home Assistant custom component for in-process setup- Whether the dev version (8.2.0.dev2334) is stable enough for production use or intended for testing only.
- Performance characteristics when controlling many devices or handling concurrent AI requests.
- Whether all nine runtime dependencies are required or if some are optional for specific features.
What it is and what it does
ha-mcp-dev is a Model Context Protocol server that bridges AI assistants (Claude, ChatGPT, etc.) to Home Assistant smart home systems. It translates natural language requests into Home Assistant API calls, allowing an AI to query device states, trigger automations, and control smart home devices without the user writing code. The package is designed to run either as a Home Assistant custom component (in-process, recommended), as a standalone HTTP server via Docker or PyPI, or over stdio for local connections.
The server handles authentication through Home Assistant tokens, webhooks, or optional OIDC providers, and exposes Home Assistant's full service and state APIs to the AI model. It depends on fastmcp for the MCP protocol implementation, httpx for HTTP communication, pydantic for data validation, cryptography for secure connections, and several utility libraries (python-dotenv, truststore, tzdata, packaging). The package is actively maintained, supports Python 3.13 and 3.14, and carries no known security vulnerabilities.
Use it for
- Let an AI assistant control lights, thermostats, and locks in your home using conversational commands.
- Query Home Assistant device states and sensor readings through an MCP-connected AI model.
- Trigger automations and scenes from an AI chat interface without manual Home Assistant UI interaction.
- Integrate Home Assistant into Claude Desktop or ChatGPT as a smart home control tool.
- Run a secure remote MCP server for AI assistants on different networks via webhook or reverse proxy.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use Home Assistant and want AI assistants to control your smart home.
The custom component install is straightforward, maintenance is active, and there are no known vulnerabilities. The dev version tag suggests this is a pre-release; verify stability for your use case before production deployment. MIT license is permissive.
Install
ha-mcp-dev on PyPI
Before you install
Low friction install as a pure Python wheel. Active maintenance with a recent release and 4381 GitHub stars. Requires Python 3.13 or 3.14 only; nine runtime dependencies are all standard ecosystem packages (fastmcp, httpx, pydantic, cryptography, etc.).
Requires Python 3.13 or 3.14; requires a running Home Assistant instance and a long-lived access token or webhook URL to connect.
License in practice
MIT license (permissive) — you can use, modify, and distribute this package freely with minimal restrictions.
Quickstart
pip install ha-mcp-dev
import ha_mcp
# Configure via environment variables (HOMEASSISTANT_URL, HOMEASSISTANT_TOKEN)
# or use the Home Assistant custom component for in-process setupVerify before relying
- Whether the dev version (8.2.0.dev2334) is stable enough for production use or intended for testing only.
- Performance characteristics when controlling many devices or handling concurrent AI requests.
- Whether all nine runtime dependencies are required or if some are optional for specific features.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <3.15,>=3.13 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 9 packagesfastmcphttpxpydanticpython-dotenvtruststorecryptographypydantic-montytzdatapackaging |
| Maintenance | Actively maintained 0 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 146,293 / month, #11,100 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Home AutomationTopic :: Software Development :: Libraries :: Python Modules |
Evidence: ha_mcp_dev-8.2.0.dev2334-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “home assistant mcp server”
- ha-mcp-devAn MCP server that lets AI assistants control Home Assistant smart…
- ha-mcpProvides a Model Context Protocol (MCP) server that connects AI…
- jupyter-server-mcpExposes Python functions as tools to MCP clients via a Jupyter Server…
Give your agent the search over MCP, or paste the wish link into any chat.
More Python Modules packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
PyYAML parses and emits YAML 1.1 data format, enabling serialization and deserialization of configuration files and Python objects to and from human-readable YAML text.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides reusable metadata objects for use with PEP-593 `typing.Annotated` to express common constraints like bounds, collection sizes, and predicates on types.
Install it if you use or build libraries that need to express type constraints in a standardized, inspectable way—or if you want to annotate your own types with…
Provides runtime tools to inspect and introspect Python type annotations, enabling programmatic examination of type hints at execution time.
See also ha-mcp · hass-nabucasa · esphome-device-builder · astro-airflow-mcp · python-matter-server · aiohomematic · arcade-mcp-server · mcpforunityserver · nextcloud-mcp-server · pagerduty-mcp