Self-hosted gateway that connects your homelab services to AI clients through the Model Context Protocol.
Connect your services once in the dashboard, then use them from Claude, ChatGPT, Cursor, Codex, Copilot, or any MCP-compatible client.
- Exposes connected services as MCP tools through a single endpoint
- Per-service and per-tool access control
- Multi-user with scoped API keys and audit logs
- 17 built-in service adapters + Generic REST for anything else
- Self-management tools let your AI agent connect services without the web UI
git clone https://github.com/johnkozaris/mcpHomeManager.git
cd mcpHomeManager
docker compose up -dOpen http://localhost:8000, create your admin account, and connect your first service.
Point your MCP client at:
http://<your-host>:8000/mcp/
Authenticate with Authorization: Bearer YOUR_API_KEY.
Works with Claude Desktop, Claude Code, Cursor, Codex, GitHub Copilot CLI, OpenCode, ChatGPT, Open WebUI, and any MCP-compatible client. See the agent setup guides for step-by-step instructions.
forgejo, homeassistant, paperless, immich, nextcloud, uptimekuma, adguard, nginxproxymanager, portainer, freshrss, wallabag, stirlingpdf, wikijs, calibreweb, tailscale, cloudflare, generic_rest
Full documentation is at mcphomemanager.com/docs.
See CONTRIBUTING.md for dev setup, architecture overview, and PR guidelines.
MIT — see LICENSE.