Nexus Agent

● Active

io.github.Fistacho/ha-nexus-agent

MCP server for Home Assistant: entities, automations, dashboards, ESPHome, energy, HACS

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "ha-nexus-agent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-i",
        "--rm",
        "ghcr.io/fistacho/nexus-agent:1.0.1"
      ],
      "env": {
        "HA_URL": "<your HA_URL>",
        "HA_TOKEN": "<your HA_TOKEN>",
        "NEXUS_READ_ONLY": "false"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env HA_URL='<your HA_URL>' --env HA_TOKEN='<your HA_TOKEN>' --env NEXUS_READ_ONLY=false --transport stdio ha-nexus-agent -- docker run -i --rm -i --rm ghcr.io/fistacho/nexus-agent:1.0.1
OpenAI Codex CLI
codex mcp add ha-nexus-agent --env HA_URL='<your HA_URL>' --env HA_TOKEN='<your HA_TOKEN>' --env NEXUS_READ_ONLY=false -- docker run -i --rm -i --rm ghcr.io/fistacho/nexus-agent:1.0.1
VS Code
code --add-mcp '{"name":"ha-nexus-agent","type":"stdio","command":"docker","args":["run","-i","--rm","-i","--rm","ghcr.io/fistacho/nexus-agent:1.0.1"],"env":{"HA_URL":"<your HA_URL>","HA_TOKEN":"<your HA_TOKEN>","NEXUS_READ_ONLY":"false"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • HA_URLrequiredBase URL of your Home Assistant instance, e.g. http://homeassistant.local:8123
  • HA_TOKENrequiredsecretHome Assistant long-lived access token (Profile -> Security -> Long-Lived Access Tokens)
  • NEXUS_READ_ONLYtrue = read-only mode: every tool not annotated read-only, including generic service calls, is hidden and refused by the server

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
IoT & Devices
Version
1.0.1
Registry
active
Published
11/21/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Nexus Agent is maintained, open source.

Maintained
Active
Last commit today (Nov 21, 2026), 1 open issues.
Official registry
Active
Published as io.github.Fistacho/ha-nexus-agent in the official MCP registry, version 1.0.1.
Source
Open source, MIT
Public repository under the MIT licence, 16 stars, 3 forks.
Runs
On your machine
A local Docker package started by your client; it can reach whatever your user account can.
Credentials
2 required
Declared environment variables: HA_URL, HA_TOKEN. They stay on your machine; the config on this page shows where each goes.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 22, 2026
Stars
16
Forks
3
Last push
Nov 21, 2026
License
MIT

Pythonai-agentanthropiccard-builderclaudeclaude-codecursoresphomefastmcphome-assistanthome-assistant-addonhome-automationhomeassistantllmlovelacemcpmcp-servermodel-context-protocolnode-redsmart-homevscode

From the README

Nexus Agent — MCP for Home Assistant Let your AI assistant build, fix and run your Home Assistant — dashboards, automations, energy, ESPHome and more. 354 tools across 32 domains · Home Assistant add-on or Docker · MIT Works with Claude Code, Claude Desktop, VS Code (Copilot), Cursor, Windsurf, OpenAI Codex CLI, Gemini CLI — any MCP client. Illustration of a typical session. Tool names, parameters and result shapes are nexus' real API; the entities and the dashboard are generic, not a real home. Latest release: v1.0.1 — fixes the MCP Registry listing of 1.0.0 (stable tool API, Docker quick start; breaking changes in the 1.0.0 notes). Release notes · all releases Installation — Home Assistant Add-on (Recommended) 1. Click the button above to add the repository to Home Assistant. 2. Find Nexus Agent in the Add-on Store → Install → Start. 3. Click Open Web UI, copy the ready-made config for your AI client and paste it in (details). Then ask: "Give me a summary of my home — what's on, what's unavailable, what needs updating." • Want to look before it can change anything? Turn on read-only mode first. • Home Assistant Container or Core (no add-ons)? See Run without the add-on (Docker). Manual Installation (Add-on Store) If the MY button does not work for your setup: 1. In Home Assistant go to Settings → Add-ons → Add-on Store 2. Click the three-dot menu (⋮) → Repositories 3. Add: 4.…

Read the full README on GitHub →

The most-starred IoT & Devices servers in the index, with their live-check result.

ServerStarsLast pushLive check
Tapo MCP877Nov 2026Local / not checked
Bagel407Nov 2026Local / not checked
eda-agent375Nov 2026Local / not checked
Bambu Printer MCP359Nov 2026Local / not checked
KiCad MCP Pro232Nov 2026Local / not checked

Nexus Agent: questions people ask

Is Nexus Agent a remote or a local MCP server?
According to its entry in the official MCP registry, Nexus Agent ships as a local package (Docker) that your client starts on your machine.
Does Nexus Agent need an API key?
Its registry entry declares 2 required environment variables: HA_URL, HA_TOKEN. The config on this page shows where each goes.
Is Nexus Agent safe to use?
Looks healthy: Nexus Agent is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: 2 required. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Nexus Agent still maintained?
Active: the repository's last commit today. Last push Nov 21, 2026, 16 GitHub stars, MIT licence. Read from GitHub on Nov 22, 2026.
How do I add Nexus Agent to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all IoT & Devices →

Add the badge to your site

Show visitors that Nexus Agent is listed here — it’s also the link we check for a free listing.

Nexus Agent — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-fistacho-ha-nexus-agent?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Nexus Agent — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Nexus Agent — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-fistacho-ha-nexus-agent?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-fistacho-ha-nexus-agent) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-fistacho-ha-nexus-agent) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-fistacho-ha-nexus-agent)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-fistacho-ha-nexus-agent"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-fistacho-ha-nexus-agent"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-fistacho-ha-nexus-agent"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).