Phoenix MCP
Provides scoped, least-privilege access to Home Assistant entities, with per-client tokens, capabilities, rate limits, optional expiry, built-in auditing, instant token revocation, a per-entity semantic safety layer (MESA), and a catalog of 131 tools for reading, controlling, and authoring Home Assistant configuration.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Phoenix MCP
English | Español | Français | Italiano | Deutsch | Nederlands | Polski | 简体中文 | 繁體中文 | 日本語 | 한국어 | Русский | Svenska | Dansk | Norsk Bokmål | Suomi
Phoenix MCP gives your AI agents safe, limited access to Home Assistant through MCP (Model Context Protocol), an open standard for connecting AI apps to tools and data. Security and safety are crucial when using AI, and Phoenix MCP has undergone many months of development and security reviews. Each agent has its own access key, limited to only the entities and capabilities you allow. An additional safety layer (MESA) can make a selected entity confirm-only or off-limits, no matter what permissions an access key is granted.
Phoenix MCP runs entirely inside Home Assistant, with no separate service to deploy. Use the apps you already have, such as Claude Code, Cursor, ChatGPT, or Gemini CLI, or chat from inside Home Assistant itself with your choice of AI provider, in the cloud or locally via Ollama.
A guided setup takes you from install to a working agent within minutes, backed by a catalog of 178 tools for reading, controlling, and authoring your configuration. Phoenix MCP uses a familiar and customizable windowed interface, making it easy to get started. Full documentation is built in and available at any time.
Screenshots

In Access Keys, each agent gets its own key. Choose a Persona, then use the Permissions Tree to decide what it can reach, down to a single entity.

In Approvals, you preview a dashboard card before it is added. Here an agent asked to add one, and nothing changes until you choose Approve.

Agent Chat is available everywhere in Home Assistant. Here it builds a card, then waits for your approval before it changes anything.

My Workspace holds the windows you use most. Here Agent Chat sits beside the Audit Log and Changes.
Related MCP server: Home Assistant MCP
Languages
The panel currently supports English, Spanish, French, Italian, German, Dutch, Polish, Russian, Simplified Chinese, Traditional Chinese, Korean, Japanese, Swedish, Danish, Norwegian, and Finnish. To change the panel language manually, open Phoenix MCP > Settings > Language and choose a language. Choose Auto to follow your Home Assistant profile language again.
Documentation
The manual is built into the panel: open the Phoenix MCP panel and choose Guide from the Help menu. It explains every window and setting, what agents can do, permissions, capabilities, MESA, and security. It follows what you select, and you can search it. The Guide is written in English, Simplified Chinese and Traditional Chinese. In the other languages only its welcome page is translated, and the other pages appear in English.
First time here? After the setup below, open the Phoenix MCP panel and choose Set Up an Agent. A wizard walks you through creating an access key, choosing what it can do, and connecting Agent Chat or your own app.
Requirements
Home Assistant 2026.7.0 or later.
One Phoenix MCP instance per Home Assistant. Home Assistant installs the dependencies
Babel>=2.18.0andjsonschema>=4.26.0for you. On a Home Assistant Core installation it also installs the requirements of the integrations Phoenix MCP starts after, such as ZHA, Bluetooth and ESPHome, even if you do not use them.
Install from the Marketplace
On Home Assistant 2026.11 or later:
Go to Settings > Marketplace and choose Add from link.
Enter
https://github.com/leecaochang/Phoenix-MCPand choose Add. The Marketplace asks you to connect GitHub the first time.Open Phoenix MCP and choose Install. Restart Home Assistant only if it asks you to.
If you upgrade from HACS, Phoenix MCP moves to the Marketplace by itself. Connect GitHub there to keep getting updates.
Install via HACS
On Home Assistant 2026.10 or earlier:
In HACS, open the top-right menu and choose Custom repositories.
Enter
https://github.com/leecaochang/Phoenix-MCPand select Integration as the category, then click Add.Find Phoenix MCP in the HACS integration list, install it, and restart Home Assistant.
Prefer to install by hand? Copy the custom_components/phoenix_mcp folder into your Home Assistant config directory under custom_components/phoenix_mcp, then restart.
Set up
Go to Settings > Devices & services > Add integration and search for Phoenix MCP. Complete the one-step setup, then open the Phoenix MCP panel in your sidebar and choose Set Up an Agent.
Issues and feedback
Report issues at github.com/leecaochang/Phoenix-MCP/issues.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect assistants to your company tools with per-person, per-action grants and a full audit log.
OAuth 2.1 short-link tools for AI agents with scoped tokens, approvals, audit logs, and revocation.
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Governed access to sensitive data, secrets and APIs for AI agents. A signed proof for each decision.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with Home Assistant to control smart home devices, query entity states, and manage automations using natural language. It provides over 90 tools for comprehensive system management, including dashboard configuration, service execution, and automation debugging.MIT
- FlicenseNot gradedqualityBmaintenanceSecure typed access to Home Assistant for AI clients like ChatGPT and Codex, with 99 tools for controlling and monitoring devices, automations, energy, and more.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to read Home Assistant entity states, call any service, and optionally apply named scene presets from a catalog using plain-English descriptions.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with Home Assistant through natural language, including device control, state queries, service execution, and management of automations, scripts, dashboards, and backups.MIT