Skip to content
Back to search

hass-mcp-server

A Home Assistant Custom Component that provides an MCP (Model Context Protocol) server using HTTP transport, allowing AI assistants like Claude to interact with your Home Assistant instance over HTTP

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/ganhammar/hass-mcp-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/ganhammar/hass-mcp-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ganhammar--hass-mcp-server/badge.svg)](/listings/ganhammar--hass-mcp-server)

HTML

<a href="/listings/ganhammar--hass-mcp-server"><img src="/api/listings/ganhammar--hass-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

HACS (Recommended)

1. Open HACS in Home Assistant 1. Search for "MCP Server" 1. Click "Download" 1. Restart Home Assistant 1. Configure the integration (see Configuration section below)

Manual Installation

1. Copy the `custom_components/mcp_server_http_transport` folder to your Home Assistant `custom_components` directory 1. Restart Home Assistant 1. Configure the integration (see Configuration section below)

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 77 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # MCP Server for Home Assistant
  2. Let an AI assistant such as Claude work with your Home Assistant: read what is going on, explain why something happened, and change automations, dashboards and devices for you. It is a custom integration that gives the assistant a set of tools for your Home Assistant, and it works wherever Home Assistant is reachable, including Claude on the web.
  3. ![Demo: Home Assistant is added to an assistant as a custom connector, Home Assistant's consent screen asks what the assistant, here a made-up one called Wren, may do and Look only is approved, and the question "Describe my home" is answered with the rooms on each floor, the lights that are on, the temperatures and an open balcony door, read through tools such as list_areas and search_entities. The assistant is illustrated; the Home Assistant screens and the data are real.](https://raw.githubusercontent.com/ganhammar/hass-mcp-server/main/docs/images/demo.gif)
  4. Things you can ask once it is connected:
  5. - "Are any lights still on upstairs?"
  6. - "Why didn't the hallway automation run last night?"
  7. - "Which automations and dashboards still use `light.kitchen`? I want to rename it."
  8. - "Add a card for the new heat pump to the energy view."
  9. - "Is anything wrong with my system right now?"
  10. - "Create a scene for movie night and an automation that starts it when the TV turns on."
  11. ## Why this one
  12. - **It administers the whole instance**, not only the entities exposed to Assist as Home Assistant's built-in MCP Server does: 117 tools for automations, dashboards, the registries, integrations, traces and diagnostics. See [how the two differ](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/faq.md#how-is-this-different-from-home-assistants-built-in-mcp-server).
  13. - **Everyone signs in as themselves.** Clients authenticate through Home Assistant as a real user, with OAuth or a long-lived access token, so there is no shared secret URL and every change is logged with who made it.
  14. - **You decide how far it reaches.** When an app connects, you choose what it may do, from Look only to Administer or area by area. On top of that come read-only mode, a switch for every tool, and opt-ins for the groups that reach furthest. A tool that is off is not even shown to the client.
  15. - **It is tested on each change** against Home Assistant 2025.6, the oldest supported version, and three newer releases up to 2026.10.
  16. ## Quick start
  17. **You need:** Home Assistant 2025.6 or newer, HACS, an administrator account and, for Claude on the web, an HTTPS address for Home Assistant that can be reached from the internet.
  18. 1. **Install.** In HACS, download "MCP Server" and "OIDC Provider", then restart Home Assistant. The OIDC Provider handles the sign-in for Claude; skip it if you will only use long-lived access tokens.
  19. 2. **Add the integrations.** Under Settings > Devices & Services > Add Integration, add "OIDC Provider" first, then "MCP Server (HTTP Transport)".
  20. 3. **Connect Claude.** In Claude, open Customize > Connectors > Add custom connector and enter `https://your-home-assistant/api/mcp_http`. Claude sends you to Home Assistant to sign in, choose what Claude may do, and approve.
  21. Choose Look only, or start in read-only mode, if you want to see what it does before letting it change anything. [Connecting a client](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/connecting.md) covers other clients and long-lived access tokens.
  22. ## What it can do
  23. | Area | Examples |
  24. |---|---|
  25. | Entities and state | Read and search entities, call any service, history, logbook and long-term statistics |
  26. | Automations, scripts and scenes | List, create, update and delete them, and search their config for a reference |
  27. | Traces | See step by step why an automation or script ran, did not run, or took the wrong branch |
  28. | Dashboards | Read an outline, change a single card with a patch, or create and remove whole dashboards |
  29. | Helpers | Create and manage toggles, counters, timers, schedules and the other helper types |
  30. | Areas, floors, devices and labels | Organize the instance: create areas and floors, move and rename devices, label things |
  31. | Integrations (opt-in) | Add an integration, change its options, reload, disable or remove it |
  32. | Diagnostics | System status, repair issues, system health, the list of backups, the error log, config validation |
  33. | Config files (opt-in) | Read and edit YAML files, with a snapshot of the top-level files before every change |
  34. | Cameras and images (opt-in) | Capture a camera frame or read a saved image for the assistant to look at |
  35. | KNX | Manage KNX entities and read recent telegrams, when KNX is set up |
  36. The [full reference](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/tools.md) lists every tool, resource and prompt. A few tools rely on Home Assistant internals and can break on an update; they are marked there.
  37. ## Staying in control
  38. - **Access per app.** The consent screen asks what each app may do: Look only, Control devices, Edit the setup or Administer, or None, Read or Full per area. It needs OIDC Provider 1.9.0 or newer. A connection from before keeps Administer until you change it with Change access under Connected applications, and in read-only mode it is held at Read.
  39. - **Read-only mode** offers only the tools that read, to every connection. Nothing can be changed.
  40. - **Disabled tools** switches off individual tools, such as `restart_ha`.
  41. - **Opt-in groups** stay off until you enable them: config files, cameras and images, templates, AppDaemon apps and integration management.
  42. - **The audit log and event** record who called what, with secrets masked.
  43. - **Only administrators can connect**, unless you decide otherwise.
  44. See [Configuration](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/configuration.md) and [Security and auditing](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/security.md).
  45. ## Documentation
  46. - [Connecting a client](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/connecting.md): Claude on the web, long-lived access tokens
  47. - [Configuration](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/configuration.md): every option, limiting the tools, the opt-in groups
  48. - [Security and auditing](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/security.md): who may connect, what each app may do, the audit log and event
  49. - [Tools, resources and prompts](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/tools.md): the full reference
  50. - [FAQ](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/faq.md): what it is, what it can do, and staying safe
  51. - [Troubleshooting](https://github.com/ganhammar/hass-mcp-server/blob/main/docs/troubleshooting.md): setup problems, path conflicts, IP bans
  52. **Updating and removing.** HACS shows updates as they are released. To remove it, delete the integration under Settings > Devices & Services, remove it in HACS, restart, and remove the connector in your client.
  53. **Help.** Questions and bugs go to the [issue tracker](https://github.com/ganhammar/hass-mcp-server/issues).
  54. ## License
  55. [MIT](https://github.com/ganhammar/hass-mcp-server/blob/main/LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.