MCP server for UniFi Network and Protect — AI assistant access to UniFi infrastructure
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add unifi-mikeholownych --env UNIFI_DEVICES='<UNIFI_DEVICES>' --env UNIFI_PASSWORD='<UNIFI_PASSWORD>' -- uvx mcp-unifi~/.codex/config.toml
[mcp_servers.unifi-mikeholownych]
command = "uvx"
args = ["mcp-unifi"]
env = { UNIFI_DEVICES = "<UNIFI_DEVICES>", UNIFI_PASSWORD = "<UNIFI_PASSWORD>" }
# codex mcp add unifi-mikeholownych --env UNIFI_DEVICES='<UNIFI_DEVICES>' --env UNIFI_PASSWORD='<UNIFI_PASSWORD>' -- uvx mcp-unifi~/.cursor/mcp.json
{
"mcpServers": {
"unifi-mikeholownych": {
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "<UNIFI_DEVICES>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"unifi-mikeholownych": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "<UNIFI_DEVICES>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"unifi-mikeholownych": {
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "<UNIFI_DEVICES>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"unifi-mikeholownych": {
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "<UNIFI_DEVICES>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"unifi-mikeholownych": {
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "<UNIFI_DEVICES>",
"UNIFI_PASSWORD": "<UNIFI_PASSWORD>"
}
}
}
}Environment variables
UNIFI_DEVICESUNIFI_PASSWORD
Replace the placeholders with your own credentials and keep them out of version control.