SSyncDev

UniFi MCP Server

Manage a Ubiquiti UniFi network: devices, clients, WiFi, firewall and VPN. Read-only by default.

Local serverstdio

What is the UniFi MCP Server?

UniFi is an MCP integration. Manage a Ubiquiti UniFi network: devices, clients, WiFi, firewall and VPN. Read-only by default.

Packages and local setup

The published oci package is ghcr.io/mattoddie/unifi-mcp:0.9.1. Its declared MCP transport is stdio.

The package declares MCP_TRANSPORT: The image serves HTTP by default; this runs it over stdio.; UNIFI_URL (required): Address of your UniFi console. For a legacy self-hosted Network application, include the port.; UNIFI_API_KEY: API key from UniFi Network → Settings → Control Plane → Integrations. Or use a username and password.; UNIFI_USERNAME: A local (not Ubiquiti cloud) account, used instead of an API key. Required for legacy controllers.; UNIFI_PASSWORD: The local account's password, used with the username.; UNIFI_TLS_FINGERPRINT: Recommended for an https controller with a self-signed certificate: its SHA-256 fingerprint, to pin it.; UNIFI_VERIFY_SSL: Leave empty when you set a fingerprint. true: publicly trusted certificate. false: skip the check (insecure).; UNIFI_SITE: The site's short name, used when a request doesn't name a site.; UNIFI_ALLOW_WRITES: Allow changes: restart devices, block clients, edit WiFi, firewall and networks. Off means read-only.; UNIFI_ALLOW_DELETES: Also allow deleting configuration and forgetting clients. Needs UNIFI_ALLOW_WRITES.; UNIFI_ALLOW_SECRETS: Allow unredacted passwords and keys (include_secrets) and the WiFi QR tool. Off keeps all output redacted.; UNIFI_TOOLSETS: Optional comma-separated list to expose fewer tools, e.g. overview,devices,clients. Empty means all except raw, which has to be listed by name.; UNIFI_RAW_ALLOWED_PATHS: Optional comma-separated API path prefixes, e.g. /api/s/default/stat, that limit the raw API tool (toolset raw) to those paths. Empty allows any path.; UNIFI_AUDIT_LOG: Set to stderr to log every change the assistant makes or previews as JSON lines. Off when empty..

The published mcpb package is https://github.com/mattoddie/unifi-mcp/releases/download/v0.9.1/unifi-mcp-0.9.1-darwin-arm64.mcpb. Its declared MCP transport is stdio.

The published mcpb package is https://github.com/mattoddie/unifi-mcp/releases/download/v0.9.1/unifi-mcp-0.9.1-darwin-amd64.mcpb. Its declared MCP transport is stdio.

The published mcpb package is https://github.com/mattoddie/unifi-mcp/releases/download/v0.9.1/unifi-mcp-0.9.1-windows-amd64.mcpb. Its declared MCP transport is stdio.

The published mcpb package is https://github.com/mattoddie/unifi-mcp/releases/download/v0.9.1/unifi-mcp-0.9.1-windows-arm64.mcpb. Its declared MCP transport is stdio.

The published mcpb package is https://github.com/mattoddie/unifi-mcp/releases/download/v0.9.1/unifi-mcp-0.9.1-linux-amd64.mcpb. Its declared MCP transport is stdio.

The published mcpb package is https://github.com/mattoddie/unifi-mcp/releases/download/v0.9.1/unifi-mcp-0.9.1-linux-arm64.mcpb. Its declared MCP transport is stdio.

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.9.1 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related other integrations MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
MCP_TRANSPORTThe image serves HTTP by default; this runs it over stdio.Check documentation
UNIFI_URLAddress of your UniFi console. For a legacy self-hosted Network application, include the port.Yes
UNIFI_API_KEYAPI key from UniFi Network → Settings → Control Plane → Integrations. Or use a username and password.Check documentation
UNIFI_USERNAMEA local (not Ubiquiti cloud) account, used instead of an API key. Required for legacy controllers.Check documentation
UNIFI_PASSWORDThe local account's password, used with the username.Check documentation
UNIFI_TLS_FINGERPRINTRecommended for an https controller with a self-signed certificate: its SHA-256 fingerprint, to pin it.Check documentation
UNIFI_VERIFY_SSLLeave empty when you set a fingerprint. true: publicly trusted certificate. false: skip the check (insecure).Check documentation
UNIFI_SITEThe site's short name, used when a request doesn't name a site.Check documentation
UNIFI_ALLOW_WRITESAllow changes: restart devices, block clients, edit WiFi, firewall and networks. Off means read-only.Check documentation
UNIFI_ALLOW_DELETESAlso allow deleting configuration and forgetting clients. Needs UNIFI_ALLOW_WRITES.Check documentation
UNIFI_ALLOW_SECRETSAllow unredacted passwords and keys (include_secrets) and the WiFi QR tool. Off keeps all output redacted.Check documentation
UNIFI_TOOLSETSOptional comma-separated list to expose fewer tools, e.g. overview,devices,clients. Empty means all except raw, which has to be listed by name.Check documentation
UNIFI_RAW_ALLOWED_PATHSOptional comma-separated API path prefixes, e.g. /api/s/default/stat, that limit the raw API tool (toolset raw) to those paths. Empty allows any path.Check documentation
UNIFI_AUDIT_LOGSet to stderr to log every change the assistant makes or previews as JSON lines. Off when empty.Check documentation