TheBoringMCP

🇬🇧 English · 🇩🇪 Deutsch

English

Talk to your home lab. Let Claude do the boring work.

TheBoringMCP connects the AI assistant Claude to the programs that run your home and your media – so you can simply ask:

"Which Docker containers are running?" · "Turn off all lights downstairs." · "Add the show Severance to Sonarr." · "Why is my SABnzbd download stuck?" · "Which firewall rules are active for the IoT network?" · "Create an n8n workflow that sends me a message when the washing machine is done."

No coding needed. You install one add-on, switch on the apps you use, and connect Claude.

What is this? (in plain words)

Claude can only talk – unless you give it "hands". These hands are called an MCP server. TheBoringMCP is one MCP server that gives Claude hands for 8 programs at once. Every program has its own on/off switch, so Claude only touches what you allow.

Every app also has a "master key" tool (e.g. sonarr_api) so Claude can reach any feature of the app's API – even ones that have no dedicated tool.

✅ Full write access to every app (can be turned into view-only with one switch). ✅ Settings page with logos and switches right inside Home Assistant (sidebar → TheBoringMCP). ✅ "Test connection" button for every app – no guessing if you typed it right.

Quick start (about 10 minutes)

1. Add the repository to Home Assistant – click this button:

   

   (or: Settings → Add-ons → Add-on Store → ⋮ → Repositories → paste https://github.com/theboringalex/TheBoringMCP)

2. Install TheBoringMCP and click Start.

3. Open TheBoringMCP in the Home Assistant sidebar. Click Generate next to the password, switch on the apps you use, paste each app's address and API key, press Test connection, then Save & restart.

4. Connect Claude (see INSTALL.md – step by step, with pictures-in-words).

👉 Complete beginner guide: INSTALL.md

Using it with Claude.ai: why several addresses?

Claude.ai accepts at most ~100 tools per connector. That is why every app gets its own connector (none of them has more than 100 tools – the biggest, Home Assistant, has 78). Create one connector per app you use, all with the same password. Claude.ai has no header field, so the password goes into the address: https://your-domain/<password>/sonarr.

(Optional bundles that stay under the limit: /arr, /media, /infra.)

Security – please read

TheBoringMCP gives full control. Always set a password (the add-on page can generate one), never open the port to the internet without HTTPS (a reverse proxy such as Nginx Proxy Manager – see the guide), and switch on Read-only mode if you only want Claude to look around.

Other ways to run it

• Docker: docker compose up -d --build (see docker-compose.yml, all values are written directly in the file – no .env needed).

• Claude Desktop / Claude Code (stdio): npm install && npm run build, then register node dist/index.js with environment variables such as SONARR_URL and SONARR_API_KEY. Set SONARR_ENABLED=false to switch an app off. Full list: DOCS.md.

Development

npm install
npm run dev     # restart on changes
npm run build   # -> dist/
npm run lint    # tsc --noEmit

Structure: src/clients/ (one API client per app) · src/tools/ (MCP tools per app) · src/admin-ui.ts + src/ui/ (settings page) · src/config.ts · src/index.ts · src/http-server.ts.

Upgrading from 1.x

Version 2 supports exactly the 8 apps above. Plex and GitHub were removed (use the official GitHub MCP server instead). Sonarr, Radarr and SABnzbd are back, with many more tools. The old /rest address still works and now means "everything except Home Assistant". See CHANGELOG.md.

License & versions

MIT – see LICENSE. Changes: CHANGELOG.md (Semantic Versioning).

Related MCP server: media-stack-mcp

Deutsch

Sprich mit deinem HomeLab. Lass Claude die langweilige Arbeit machen.

TheBoringMCP verbindet den KI-Assistenten Claude mit den Programmen, die dein Zuhause und deine Medien steuern – du kannst einfach fragen:

„Welche Docker-Container laufen gerade?" · „Mach unten alle Lichter aus." · „Füge die Serie Severance zu Sonarr hinzu." · „Warum hängt mein SABnzbd-Download?" · „Welche Firewall-Regeln gelten für das IoT-Netz?" · „Bau mir einen n8n-Workflow, der mir Bescheid gibt, wenn die Waschmaschine fertig ist."

Du musst nicht programmieren können. Du installierst ein Add-on, schaltest die Programme ein, die du nutzt, und verbindest Claude.

Was ist das? (einfach erklärt)

Claude kann von sich aus nur reden – außer du gibst ihm „Hände". Diese Hände heißen MCP-Server. TheBoringMCP ist ein MCP-Server, der Claude Hände für 8 Programme gleichzeitig gibt. Jedes Programm hat einen eigenen Ein/Aus-Schalter – Claude fasst nur an, was du erlaubst.

Jedes Programm hat zusätzlich ein „Generalschlüssel"-Tool (z. B. sonarr_api), mit dem Claude jede Funktion der Programm-Schnittstelle erreicht – auch solche ohne eigenes Tool.

✅ Volle Schreibrechte auf jedes Programm (mit einem Schalter auf „nur ansehen" umstellbar). ✅ Einstellungsseite mit Logos und Schaltern direkt in Home Assistant (Seitenleiste → TheBoringMCP). ✅ „Verbindung testen"-Knopf bei jedem Programm – kein Rätselraten, ob alles stimmt.

Schnellstart (ca. 10 Minuten)

1. Repository zu Home Assistant hinzufügen – klicke auf diesen Knopf:

   

   (oder: Einstellungen → Add-ons → Add-on-Store → ⋮ → Repositories → https://github.com/theboringalex/TheBoringMCP einfügen)

2. TheBoringMCP installieren und auf Starten klicken.

3. TheBoringMCP in der Home-Assistant-Seitenleiste öffnen. Neben dem Passwort auf Erzeugen klicken, die Programme einschalten, die du nutzt, jeweils Adresse und API-Schlüssel einfügen, Verbindung testen drücken und dann Speichern & neu starten.

4. Claude verbinden (siehe INSTALL.md – Schritt für Schritt, in einfachen Worten).

👉 Komplette Einsteiger-Anleitung: INSTALL.md

Nutzung mit Claude.ai: Warum mehrere Adressen?

Claude.ai erlaubt höchstens ~100 Tools pro Connector. Deshalb bekommt jedes Programm seinen eigenen Connector (keins hat mehr als 100 Tools – das größte, Home Assistant, hat 78). Lege pro genutztem Programm einen Connector an, überall mit demselben Passwort. Claude.ai hat kein Header-Feld, daher steht das Passwort in der Adresse: https://deine-domain/<passwort>/sonarr.

(Optionale Bündel unterhalb des Limits: /arr, /media, /infra.)

Sicherheit – bitte lesen

TheBoringMCP gibt volle Kontrolle. Setze immer ein Passwort (die Einstellungsseite kann eins erzeugen), öffne den Port nie ohne HTTPS ins Internet (Reverse Proxy wie Nginx Proxy Manager – siehe Anleitung) und schalte den Nur-Lesen-Modus ein, wenn Claude nur zuschauen soll.

Andere Betriebsarten

• Docker: docker compose up -d --build (siehe docker-compose.yml, alle Werte stehen direkt in der Datei – keine .env nötig).

• Claude Desktop / Claude Code (stdio): npm install && npm run build, dann node dist/index.js mit Umgebungsvariablen wie SONARR_URL und SONARR_API_KEY eintragen. Mit SONARR_ENABLED=false schaltest du ein Programm aus. Vollständige Liste: DOCS.md.

Entwicklung

npm install
npm run dev     # Neustart bei Änderungen
npm run build   # -> dist/
npm run lint    # tsc --noEmit

Struktur: src/clients/ (ein API-Client pro Programm) · src/tools/ (MCP-Tools pro Programm) · src/admin-ui.ts + src/ui/ (Einstellungsseite) · src/config.ts · src/index.ts · src/http-server.ts.

Update von 1.x

Version 2 unterstützt genau die 8 Programme oben. Plex und GitHub wurden entfernt (nutze stattdessen den offiziellen GitHub-MCP-Server). Sonarr, Radarr und SABnzbd sind zurück – mit deutlich mehr Tools. Die alte Adresse /rest funktioniert weiter und bedeutet jetzt „alles außer Home Assistant". Siehe CHANGELOG.md.

Lizenz & Versionen

MIT – siehe LICENSE. Änderungen: CHANGELOG.md (Semantic Versioning).