AI toolkit for Homebridge: an MCP server that lets Claude and other AI assistants control accessories, manage plugins and config, and read logs, plus a Homebridge plugin and shared AI building blocks.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add homebridge --env HOMEBRIDGE_URL='<HOMEBRIDGE_URL>' --env HOMEBRIDGE_TOKEN='<HOMEBRIDGE_TOKEN>' --env HOMEBRIDGE_PASSWORD='<HOMEBRIDGE_PASSWORD>' -- npx -y @mp-consulting/homebridge-ai-kit~/.codex/config.toml
[mcp_servers.homebridge]
command = "npx"
args = ["-y", "@mp-consulting/homebridge-ai-kit"]
env = { HOMEBRIDGE_URL = "<HOMEBRIDGE_URL>", HOMEBRIDGE_TOKEN = "<HOMEBRIDGE_TOKEN>", HOMEBRIDGE_PASSWORD = "<HOMEBRIDGE_PASSWORD>" }
# codex mcp add homebridge --env HOMEBRIDGE_URL='<HOMEBRIDGE_URL>' --env HOMEBRIDGE_TOKEN='<HOMEBRIDGE_TOKEN>' --env HOMEBRIDGE_PASSWORD='<HOMEBRIDGE_PASSWORD>' -- npx -y @mp-consulting/homebridge-ai-kit~/.cursor/mcp.json
{
"mcpServers": {
"homebridge": {
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"homebridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"homebridge": {
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"homebridge": {
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"homebridge": {
"command": "npx",
"args": [
"-y",
"@mp-consulting/homebridge-ai-kit"
],
"env": {
"HOMEBRIDGE_URL": "<HOMEBRIDGE_URL>",
"HOMEBRIDGE_TOKEN": "<HOMEBRIDGE_TOKEN>",
"HOMEBRIDGE_PASSWORD": "<HOMEBRIDGE_PASSWORD>"
}
}
}
}Environment variables
HOMEBRIDGE_URLHOMEBRIDGE_TOKENHOMEBRIDGE_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.