Brand New Claude.ai & ChatGPT integration (ha-mcp)

Share your Projects! Custom Integrations
, ,
42

@jld thank you for the help, I tried again, but ran into another odd issue that I could not figure out. (Tried Mistral Vibe, but it didn’t help much).
I have created a bug ticket: [BUG] ha_list_integrations runs into "Name or service not known" · Issue #488 · homeassistant-ai/ha-mcp · GitHub

43

Can you please add instructions for opencode?

Also, I have a question. According to gemeni I need to switch from stdio to sse (http). How can I do this in docker compose? EDIT: I found the solution: command: ha-mcp-web

Thank you

44

Please open an issue on Github. I’m a bit busy this week. Someone might be able to help.
Here is the general docs: MCP servers | OpenCode
If you get it working… open an issue on Github anyways so we can add your instructions. Thanks

45

Awesome setup, thanks.

Been trying to get Claude desktop to help changing some of my old blueprints. Look like Claude desktop can not access the blueprint code. Any plans to implement this functionality

46

This is really good. For some reason, it became insanely slow for me. Is it on the server side or related to my computer?

47

I have my own python Assistant, speech ui with headset, local gpt-oss-120b and can connect to stdio/streamable MCPs. Already tried the “official” MCP Server, but it does no return entitys attributes, and I have for instance electricity prices in json attributes. Does this return attributes?

Is there way to restrict used tools? I’m not planning to do anything more than create a subset of sensors and some switches and keep strict control what LLM can access. With speech interface it’s better to be safe than sorry.

48

There were some improvements to use blueprint recently, but I don’t think we support creating blueprints.

Open an issue (feature request) on Github

49

I’m not aware of any performance problems. There is no “server side” since it’s all run on your machine and on your Home assistant server. Slowness could be caused by many things. You can ask your agent for a bug report and open an issue on Github with it.

50

Currently no. I would use an MCP proxy of some sort. Try to find an MCP gateway, proxy or router. There are many projects out there. Personally I use a custom MCP proxy made with FastMCP.

Let me know if it works. We had trouble in the past with local models using OpenWebUI. Maybe too much tools… not sure!

51

How about those attributes? Do they show?

Like I said, I have my own code for connecting to MCP, so I can whitelist myself what to use.

Does this respect what devices actually exposed to assistants or is every device shown and allowed to be changed?

52

Hey sorry if these questions are newbie-ish, but I’m having two issues, hoped you could help with, btw when this works its amazing, I’m copying dashboards, refactoring automations, etc’ its beautiful! I’m using claude code on macOS.
I install per your instructions:

claude mcp add homeassistant \                                                                                                                      ─╯
  --env HOMEASSISTANT_URL=http://[myInternalHAIP:8123 \
  --env HOMEASSISTANT_TOKEN=MySecretToken \
  -- uvx ha-mcp@latest

This works fine, but two issues:

  1. it loses it after a day or so, when I go back to my terminal and do an claude mcp list its not there and I have to rerun - how do I keep it there?
  2. what command/flag can I gave to mcp add, to run it locally across all project on my machine?
  3. what flag do I need to add for it not to ask me for permissions every 5 seconds when its working?
    Thanks!!!
53

For 2 and 3… just ask your Claude Code. He can help with that. There is an allow list. and he can guide you with the command syntax.

For #1… I had the issue before, not only for ha-mcp, but for other MCP servers too. Not sure what is going on, but I don’t currently use ha-mcp in Claude Code. Open an issue on Github with logs if you can. Workarround: Quit then resume the session with /resume.

54

Tool annotations: Schema Reference - Model Context Protocol

All devices.

55

Tried to install ha-mcp on my Mac today (latest version OS).

Followed step by step the simple setup guide:

  1. created account
  2. run installer (this showed-up during setup:
    sh: line 160: 8903 Killed: 9 "$UVX_PATH" --refresh ha-mcp@latest --version > /dev/null 2>&1t
  3. installed claude.app
  4. upon starting claude app, I get notification “MCP Home Assistant: Server disconnected …”

Log files shows:

2026-02-09T11:10:53.280Z [Home Assistant] [info] Client transport closed { metadata: undefined }
2026-02-09T11:10:53.280Z [Home Assistant] [info] Shutting down server... { metadata: undefined }
2026-02-09T11:10:53.280Z [Home Assistant] [info] Initializing server... { metadata: undefined }
2026-02-09T11:10:53.284Z [Home Assistant] [info] Using MCP server command: /Users/wimjanse/.local/bin/uvx with args and path: {
  metadata: {
    args: [ '--refresh', 'ha-mcp@latest', [length]: 2 ],
    paths: [
      '/usr/local/bin',
      '/usr/bin',
      '/bin',
      '/usr/sbin',
      '/sbin',
      [length]: 5
    ]
  }
} %o
2026-02-09T11:10:53.285Z [Home Assistant] [info] Server started and connected successfully { metadata: undefined }
2026-02-09T11:10:53.296Z [Home Assistant] [info] Message from client: {"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0} { metadata: undefined }
2026-02-09T11:10:53.330Z [Home Assistant] [info] Server transport closed { metadata: undefined }
2026-02-09T11:10:53.330Z [Home Assistant] [info] Client transport closed { metadata: undefined }
2026-02-09T11:10:53.330Z [Home Assistant] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. `console.error('...')` in JavaScript, `print('...', file=sys.stderr)` in python) and it will appear in this log. { metadata: undefined }
2026-02-09T11:10:53.330Z [Home Assistant] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) { metadata: { context: 'connection', stack: undefined } }
2026-02-09T11:10:53.331Z [Home Assistant] [info] Client transport closed { metadata: undefined }

Could someone help me with this issue please.

EDIT: I narrowed down the issue to uv/uvx. uvx is not running on my system, even a simple uvx --version directly results into a Killed 9 proces. I’m checking the GitHub uvx repository, more people using MacOS are/have faced this issue.

EDIT2-SOLVED: I have F-Secure as a virus-checker on my Mac. F-Secure’s Deep Guard prevented uvx from running. Funny thing is that I didn’t get a notification from F-Secure about this. After a few hours of debugging I finally found the issue. All’s well that end well.

56

I am seeing a manifest error in the supervisor logs when trying to update to the latest version.

57

Hello @Jid and many many thanks for this reat integration! I set it up on Windows correctly and waas able to use it smoothless for a couple of days. All of a sudden at any query it stays stuck saying it’s taking more time than usual and is giving up to 10 tentatives. Any idea?

58

Click that thinkin thingy open, Claude have bug atm.