Home Assistant MCP Server
CommunityMCP server by jarahkon · updated · ★ 0 · 99 downloads a week
MCP server for full Home Assistant control — dashboards, files, automations, add-ons, and more Home Assistant MCP Server is a community project by jarahkon, not verified by a company domain.
Last commit 195 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
HA_Environment variable | Required | Home Assistant base URL (e.g. http://homeassistant.local:8123) |
HA_Environment variable, secret | Required | Home Assistant long-lived access token |
HA_Environment variable | Optional | SSH hostname for file management (optional) |
HA_Environment variable | Optional | SSH port (default: 22) |
HA_Environment variable | Optional | SSH username (must be root) |
HA_Environment variable | Optional | Path to SSH private key |
HA_Environment variable, secret | Optional | SSH password (alternative to key) |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install Home Assistant MCP Server
Built from the published package, never by AIclaude mcp add home-assistant-mcp-server -e HA_URL=YOUR_HA_URL -e HA_TOKEN=YOUR_HA_TOKEN -- npx -y @jarahkon/hass-mcp-serverRun in your terminal. Add --scope user to use it in every project.
Step-by-step: install Home Assistant MCP Server in Claude Code
{
"mcpServers": {
"home-assistant-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jarahkon/hass-mcp-server"
],
"env": {
"HA_URL": "YOUR_HA_URL",
"HA_TOKEN": "YOUR_HA_TOKEN"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
Step-by-step: install Home Assistant MCP Server in Claude Desktop
{
"mcpServers": {
"home-assistant-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jarahkon/hass-mcp-server"
],
"env": {
"HA_URL": "YOUR_HA_URL",
"HA_TOKEN": "YOUR_HA_TOKEN"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"home-assistant-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jarahkon/hass-mcp-server"
],
"env": {
"HA_URL": "YOUR_HA_URL",
"HA_TOKEN": "YOUR_HA_TOKEN"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add home-assistant-mcp-server --env HA_URL=YOUR_HA_URL --env HA_TOKEN=YOUR_HA_TOKEN -- npx -y @jarahkon/hass-mcp-server{
"mcpServers": {
"home-assistant-mcp-server": {
"command": "npx",
"args": [
"-y",
"@jarahkon/hass-mcp-server"
],
"env": {
"HA_URL": "YOUR_HA_URL",
"HA_TOKEN": "YOUR_HA_TOKEN"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
Step-by-step: install Home Assistant MCP Server in Antigravity CLI
gemini mcp add home-assistant-mcp-server npx -y @jarahkon/hass-mcp-serverGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
Step-by-step: install Home Assistant MCP Server in Gemini CLI
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the home-assistant-mcp-server block.
Weekly newsletter
Like Home Assistant MCP Server? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Alternatives to Home Assistant MCP Server
All alternatives →Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
Open-source Obsidian for MDX - edit local docs with agent assistance
A private persistent computer: files and a bash shell that survive between runs.
MCP server for terminal commands, file operations, and process management
Filesystem-first framework for durable backend AI agents that run anywhere.
W3C Web Model Context Protocol (WebMCP) API polyfill. Let AI agents like Claude, ChatGPT, and Gemini interact with your website via document.modelContext.
Home Assistant MCP Server: common questions
How do I install Home Assistant MCP Server?
In Claude Code run claude mcp add home-assistant-mcp-server -e HA_URL=YOUR_HA_URL -e HA_TOKEN=YOUR_HA_TOKEN -- npx -y @jarahkon/hass-mcp-server. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Home Assistant MCP Server the official server?
Home Assistant MCP Server is a community project by jarahkon, not verified by a company domain.
Is Home Assistant MCP Server free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is Home Assistant MCP Server safe to use?
It scores 57 of 100. Grades: maintenance D, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to Home Assistant MCP Server?
Similar MCP servers: mcp-server, Agent-Native Content, Computer, Desktop Commander.
Does Home Assistant MCP Server work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
