Nexus Agent
● Activeio.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.
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"
}
}
}
}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.1codex 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.1code --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.
- 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
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks 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 →Alternatives to Nexus Agent
All Nexus Agent alternatives →Best IoT & Devices servers →The most-starred IoT & Devices servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Tapo MCP | 877 | Nov 2026 | Local / not checked |
| Bagel | 407 | Nov 2026 | Local / not checked |
| eda-agent | 375 | Nov 2026 | Local / not checked |
| Bambu Printer MCP | 359 | Nov 2026 | Local / not checked |
| KiCad MCP Pro | 232 | Nov 2026 | Local / 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.
More IoT & Devices servers
Browse all IoT & Devices →Autopm
fluidumber
18 AI product-management robots for market research, financials, and execution specs. No API keys
LEEVAR reliability battery
forevercrab321-svg
Grade an AI agent's transcripts on 18 reliability tests. Thin evidence is NOT TESTED, not guessed.
InkRelay
GauravBR
Print PDFs, ZPL labels and ESC/POS receipts on your printers and follow print jobs via InkRelay
Pumperly
GeiserX
Cheapest fuel and EV charging near a place or along a drive, in about 40 countries
Tesla Wrap Design
GhostCatcg
Design Tesla Paint Shop wraps from your AI assistant with 3D preview and export links.
Slicewise
gjlmotea
Pre-print checks for Bambu Studio: GUI-faithful CLI slicing, override audit, printability.
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.
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
[](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.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-fistacho-ha-nexus-agent) [](https://serverdex.io/install/vscode/io-github-fistacho-ha-nexus-agent) [](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).