Skip to main content
MCP server CX Codex

Home Assistant — Claude Code MCP server: features and setup

The MCP server for Claude Code reads Home Assistant data and runs its actions. An agent can inspect device states, check history, or change home settings.

MIT ★ 5 updated 2026-10-29

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL> --env HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE> --env HOME_ASSISTANT_CONFIRM_DOMAINS=<HOME_ASSISTANT_CONFIRM_DOMAINS> --transport stdio home-assistant -- npx -y @foreverworks/mcp-home-assistant
Open on GitHub

What Home Assistant does

The server gives an AI agent access to Home Assistant entities, areas, history, and logbook entries. It can also run actions, such as adjusting a light, changing a thermostat, or starting a script. Each action involving locks, alarm panels, covers, or valves requires approval before it runs.

The machine needs network access to a Home Assistant instance and a long-lived access token. The package @foreverworks/mcp-home-assistant runs on Node 22.19 or newer; set HOME_ASSISTANT_URL to the instance address and HOME_ASSISTANT_TOKEN_FILE to the token file path. A regular user's token supports every tool except render_template; an administrator token also enables admin-only actions.

What it helps with

  • inspect device states and their areas
  • check Home Assistant history and logbook entries
  • adjust a light or thermostat setting
  • run an action that requires approval

Example prompts for the agent

  • Which devices are active in the living room?
  • How did the living room temperature shift overnight?
  • Set the kitchen light to 30 percent brightness.

How to install Home Assistant

Platform CLI

claude mcp add --env HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL> --env HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE> --env HOME_ASSISTANT_CONFIRM_DOMAINS=<HOME_ASSISTANT_CONFIRM_DOMAINS> --transport stdio home-assistant -- npx -y @foreverworks/mcp-home-assistant

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Home Assistant

How do I install Home Assistant in Claude Code?

Run `claude mcp add home-assistant -e HOME_ASSISTANT_URL=<HOME_ASSISTANT_URL> -e HOME_ASSISTANT_TOKEN_FILE=<HOME_ASSISTANT_TOKEN_FILE> -- npx -y @foreverworks/mcp-home-assistant`. Set the Home Assistant address and the path to a file containing a long-lived access token.

What does the Home Assistant MCP server do?

It gives an agent access to Home Assistant entities, areas, history, and logbook data, and lets it run actions. Actions involving locks, alarm panels, covers, and valves require approval each time.

What does the Home Assistant MCP server need to run?

It requires a reachable Home Assistant instance, a long-lived access token, and Node 22.19 or newer. Configure the address with HOME_ASSISTANT_URL and the token file path with HOME_ASSISTANT_TOKEN_FILE.

Similar MCP servers

MCP servers catalog →

From the same set15

The whole set →
TypeSafe TypeSafe is an MCP server for Claude Code that scores claims, choices, and ordered scales. It can handle one item or batches of up to 1000 rows. CX Codex +1 ★ 5repo stars Trademark search The Trademark search Claude Code MCP server searches registered and pending trademarks in the US and EU. It matches names against Nice classes and goods or services descriptions. CX Codex +1 ★ 5repo stars Porkbun This MCP server for Claude Code manages domains and DNS through a Porkbun account. It handles requests to register a domain, configure mail, or publish a static site. CX Codex +1 ★ 5repo stars ONRC trade register The ONRC trade register MCP server for Claude Code reads filing details from Romania’s trade register. It retrieves filing documents and shows fee notes and unpaid invoice balances. CX Codex +1 ★ 5repo stars eToll (rovinietă) eToll (rovinietă) is an MCP server for Claude Code that checks Romanian rovinietă vignettes and invoices in an eToll account. It prices a vignette and submits an order after confirmation. CX Codex +1 ★ 5repo stars ECB exchange rates The ECB exchange rates MCP server for Claude Code fetches the European Central Bank’s euro reference rates and converts amounts between currencies. Ask for a rate on a specific date or for a period. CX Codex +1 ★ 5repo stars Expo Application Services Expo Application Services is an MCP server for Claude Code that diagnoses failed builds, workflow runs, and store submissions. It can also inspect credentials and manage updates. CX Codex +1 ★ 5repo stars Bitwarden This MCP server for Claude Code connects an agent to a separate Bitwarden vault. It handles login records, 2FA codes, and passkeys. CX Codex +1 ★ 5repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open