Home Assistant MCP Server

What is Home Assistant MCP Server?

This is a Model Context Protocol (MCP) server for interacting with Home Assistant. It provides tools to control and monitor Home Assistant devices through MCP-enabled applications, such as Claude Desktop. It is designed for Home Assistant users who want to integrate AI assistants with their smart home setup.

How to use Home Assistant MCP Server?

Install automatically via Smithery (npx -y @smithery/cli install @hekmon8/Homeassistant-server-mcp --client claude) or manually by cloning the repo, running npm install and npm run build, then configuring the MCP settings file with your Home Assistant URL (HA_URL) and a long-lived access token (HA_TOKEN). The server exposes four tools: get_state, toggle_entity, trigger_automation, and list_entities.

Key features of Home Assistant MCP Server

• Get device states from Home Assistant
• Control device states (turn on/off)
• Trigger automations by automation ID
• List available entities, optionally filtered by domain

Use cases of Home Assistant MCP Server

• Ask an AI assistant to turn lights on/off
• Query the current state of any Home Assistant entity
• Trigger a morning routine automation from a chat interface
• List all lights or switches in the system to discover entities
• Monitor and control smart home devices without opening the Home Assistant UI

FAQ from Home Assistant MCP Server

What are the runtime dependencies?

Node.js and npm are required to build and run the server. A running Home Assistant instance with a long-lived access token is also needed.

How do I securely provide my Home Assistant credentials?

Set the HA_URL and HA_TOKEN environment variables in your MCP settings file. Always use HTTPS for your Home Assistant instance, keep access tokens secret, and never commit them to version control.

Where does my data live?

All device data stays on your local Home Assistant instance. The MCP server only reads from and writes to your instance; no data is sent to external services.

What transport protocol does the server use?

The server uses the standard Model Context Protocol (MCP) for communication with MCP-enabled clients.

How can I contribute or get support?

Fork the repository and submit pull requests. For issues, check existing repository issues or create a new one with context. Additional support resources are available at www.aimcp.info.