MCP server
Home Assistant MCP server
Home Assistant's built-in MCP server lets AI read the state of exposed devices and control them, such as lights, climate and covers.
- Official server
- Automation
At a glance
- Maintained by
- Home Assistant (Open Home Foundation)
- Tools exposed
- 8 listed below
- Reviewed
- September 24, 2026
Why it matters
What it does and why it matters
Home Assistant is an open-source platform for controlling smart devices, used in homes and increasingly in small offices, shops and rental properties. Its built-in MCP server lets an assistant read the state of devices you choose to expose and control them: turn things on and off, set lights and temperatures, move blinds and manage lists.
For small facilities, that means questions such as "is the heating on in the meeting room" and actions such as "turn off all lights on floor two" in plain language.
The tools are Home Assistant intents, and what the assistant can control depends on which devices you expose. Expose only the devices that are safe for an assistant to control, and never locks, alarms or safety systems without careful thought and confirmation steps.
Use cases
Best business use cases
Climate
Lighting
Blinds and covers
Status checks
Shared lists
Tools
Available tools
Tool names as published by the maintainer at review time. Versions change, so check the repository for the current list.
Tools come from the Assist API the integration exposes; names are Home Assistant built-in intents (developers.home-assistant.io/docs/intent_builtin). Which tools appear depends on exposed entities and chosen LLM API.
Read and write: Read and write: read device state and control exposed devices only.
-
HassTurnOnTurn on a device or entity.
-
HassTurnOffTurn off a device or entity.
-
HassGetStateCheck the state of an entity.
-
HassLightSetSet a light's brightness or color.
-
HassClimateSetTemperatureSet the target indoor temperature.
-
HassSetPositionSet the position of a cover or similar entity.
-
HassListAddItemAdd an item to a to-do list.
-
HassMediaPausePause a media player.
Workflows
Example workflows
End-of-day check
-
1
Ask what is still on in the office.
-
2
The assistant reads device states.
-
3
It lists lights and heating that are on.
-
4
You confirm what to turn off.
-
5
It switches them off.
Prepare a meeting room
-
1
Ask to prepare room 2 for 10 a.m.
-
2
The assistant sets the temperature.
-
3
It turns on the lights.
-
4
It opens the blinds.
-
5
It confirms the room is ready.
Prompts
Example prompts
“What lights and heating are still on in the office?”
“Set the meeting room to 21 degrees.”
“Turn off all lights on the second floor.”
Setup
Installation and configuration
Examples for Claude Desktop and Claude Code. Replace the placeholder values with your own keys, and store secrets outside version control.
Claude Desktop: claude_desktop_config.json
{
"mcpServers": {
"Home Assistant": {
"command": "mcp-proxy",
"args": [
"--transport=streamablehttp",
"--stateless",
"http://<your_local_home_assistant_ip_or_url>:8123/api/mcp"
],
"env": {
"API_ACCESS_TOKEN": "<your_access_token_here>"
}
}
}
}Claude Code: terminal
claude mcp add-json "HA" '{"type": "http", "url": "https://<your_home_assistant_url>/api/mcp", "oauth": {"clientId": "http://localhost:12345", "callbackPort": 12345}}' --client-secret- Hosted server: http(s)://<your_home_assistant_url>/api/mcp (Streamable HTTP, served by your Home Assistant).
- Needs: OAuth (IndieAuth) or a Home Assistant long-lived access token..
- Claude Desktop: This JSON is the documented local setup. For a remote HA, docs use a custom connector with OAuth.
Security
Security considerations
-
Expose carefully
Expose only devices that are safe for an assistant to control.
-
Locks and alarms
Do not expose locks, alarms or safety systems without confirmation steps.
-
Access tokens
Use a dedicated long-lived token and protect it.
-
History
Review device history for unexpected actions.
Related servers
Servers that pair well with it
n8n
n8n's official instance-level MCP server lets AI search, run, build, update and publish workflows and look up nodes and credentials.
Zapier
Zapier's official MCP server lets AI discover, enable and run actions across thousands of connected apps, with separate read and write tools.
Time
The MCP project's Time reference server gives AI the current time in any time zone and converts times between zones.
Keep exploring
Solutions and services that use it
Related services
View all related services- MCP integration Connect AI assistants to your CRM, files, databases and tools through Model Context Protocol servers, with safe permissions.
- Business process automation Map a process that runs on email and spreadsheets and turn it into software with clear steps and owners.
- Automation and Integrations CRM, payment and API integrations, MCP connections and workflows that stop people copying data by hand.
- AI workflows Step-by-step automations where AI handles the reading, sorting and drafting inside a process you control.
- Webhooks and event systems Systems that react the moment something happens, such as a payment, a signup or a form, instead of waiting for a nightly job.
- Internal tools Custom software for your own team: trackers, approval flows and back-office systems that replace spreadsheets.
Solutions
View all solutions- Approval workflows Requests, approvals and reminders in one place, with clear owners and deadlines instead of long email threads.
- Compliance tracking Track filing deadlines, licenses and obligations in one place, with reminders and AI summaries of relevant rule changes.
- AI automation and integrations Connect the tools you already use so data moves once, correctly, and AI reads the parts that arrive as text or documents.
- Scheduling and drafting automation Turn one piece of content into posts for each channel, schedule them and track results, with approval before anything goes out.
- Onboarding automation Every new hire gets the right accounts, documents, training and check-ins on time, tracked in one place.
Industries
View all industriesCase studies
View all case studies- Tax filing service platform Clients upload documents and see where their case stands, and staff work from one queue with deadlines and reminders.
- Facility management platform Every request, inspection and cost for every building now lives in one place, with a clear owner and status.
- Payroll system for an IT services company Payroll is calculated from recorded inputs, reviewed once and sent as payslips in a single batch, with every change logged.
- Vacation rental operations system One calendar per property, cleaning tasks created from bookings, and owner statements built from the same records.
Guides and articles
View all guides and articles- AI automation vs traditional automation How rule-based automation and AI automation differ, where each fits and how to combine them.
- How to automate payroll Turn a manual monthly payroll into a reviewed, tested process with accurate payslips and a full audit trail.
- No-code vs custom development Where no-code tools shine, where they hit limits, and when custom software pays off.
- How to measure the ROI of AI automation Measure the return on AI automation with a baseline, the right metrics and honest accounting of costs.
- How to build an AI workflow with MCP servers Plan, connect and test an AI workflow that uses MCP servers, from a single task to a reliable process.
- MCP security best practices How to choose, configure and monitor MCP servers so AI assistants get the access they need and nothing more.
Glossary terms
View all glossary terms- Workflow automation Workflow automation uses software to move work through a series of steps, such as routing, approvals and notifications, based on rules and events.
- Webhook A webhook is an automatic message one system sends to another's web address when something happens, such as a payment or a new order.
- Automation Automation is using software to perform a task or process with little or no human effort each time it runs.
- Business process automation Business process automation uses software to run a multi-step business process, such as approvals or onboarding, from start to finish with less manual work.
- No-code No-code tools let people build apps, websites and automations with visual editors instead of writing code.
- AI agent An AI agent is software that uses a language model to plan steps, call tools and act toward a goal, instead of only answering one question.
FAQ
Questions people ask us
Have a question that is not here? Ask us directly.
Yes. It is built into Home Assistant.
Only the devices you expose to it.
It suits small offices, shops and rental properties that use Home Assistant.