GitHits
Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.
Manage a Ubiquiti UniFi network: devices, clients, WiFi, firewall and VPN. Read-only by default.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 4/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 16/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install UniFi. Follow https://mcp.popnx.com/i/mattoddie-unifi-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 17, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a UniFi key (create it on the maker’s site) · 2 setting(s) to fill in (UNIFI_URL, UNIFI_USERNAME) · Only the Claude desktop app (Windows or Mac), not the web or phone
Download the maker’s .mcpb file
The .mcpb file comes straight from the maker; we do not change it
Use UniFi and tell me what you can do for me, then show me one thing✓ If Claude says it is using UniFi or shows a UniFi tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
MCP_TRANSPORT The image serves HTTP by default; this runs it over stdio. · default stdioUNIFI_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. · default defaultUNIFI_ALLOW_WRITES Allow changes: restart devices, block clients, edit WiFi, firewall and networks. Off means read-only. · default falseUNIFI_ALLOW_DELETES Also allow deleting configuration and forgetting clients. Needs UNIFI_ALLOW_WRITES. · default falseUNIFI_ALLOW_SECRETS Allow unredacted passwords and keys (include_secrets) and the WiFi QR tool. Off keeps all output redacted. · default falseUNIFI_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.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect UniFi yet
UniFi runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect UniFi
B · Others in Cybersecurity that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a UniFi key (create it on the maker’s site) · 2 setting(s) to fill in (UNIFI_URL, UNIFI_USERNAME) · Install Docker on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server UniFi for Claude Code on this computer, in this order: 1) Check Docker with docker --version. If it is missing, tell me to install it from https://www.docker.com/products/docker-desktop/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user unifi --env UNIFI_URL=your-value --env UNIFI_API_KEY=your-value --env UNIFI_USERNAME=your-value --env UNIFI_PASSWORD=your-value -- docker run -i --rm -e UNIFI_URL -e UNIFI_API_KEY -e UNIFI_USERNAME -e UNIFI_PASSWORD ghcr.io/mattoddie/unifi-mcp:0.9.1 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For UNIFI_API_KEY, UNIFI_PASSWORD, UNIFI_URL, UNIFI_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the UniFi tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
docker --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Install Docker Desktop: on Mac open Docker.dmg and drag the icon to Applications (pick Apple silicon or Intel to match your Mac) · on Windows double-click Docker Desktop Installer.exe · then open the Docker Desktop app and leave it running. No curl command needed
Open the Docker download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: docker --version
Install once; it works for everything that needs Docker
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
UNIFI_URL Address of your UniFi console. For a legacy self-hosted Network application, include the port.UNIFI_USERNAME A local (not Ubiquiti cloud) account, used instead of an API key. Required for legacy controllers.Descriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user unifi --env UNIFI_URL=your-value --env UNIFI_API_KEY=your-value --env UNIFI_USERNAME=your-value --env UNIFI_PASSWORD=your-value -- docker run -i --rm -e UNIFI_URL -e UNIFI_API_KEY -e UNIFI_USERNAME -e UNIFI_PASSWORD ghcr.io/mattoddie/unifi-mcp:0.9.1Replace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see UniFi listed as connected
Use UniFi and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using UniFi or shows a UniFi tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
MCP_TRANSPORT The image serves HTTP by default; this runs it over stdio. · default stdioUNIFI_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. · default defaultUNIFI_ALLOW_WRITES Allow changes: restart devices, block clients, edit WiFi, firewall and networks. Off means read-only. · default falseUNIFI_ALLOW_DELETES Also allow deleting configuration and forgetting clients. Needs UNIFI_ALLOW_WRITES. · default falseUNIFI_ALLOW_SECRETS Allow unredacted passwords and keys (include_secrets) and the WiFi QR tool. Off keeps all output redacted. · default falseUNIFI_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.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a UniFi key (create it on the maker’s site) · 2 setting(s) to fill in (UNIFI_URL, UNIFI_USERNAME) · Install Docker on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server UniFi for Cursor on this computer, in this order: 1) Check Docker with docker --version. If it is missing, tell me to install it from https://www.docker.com/products/docker-desktop/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "unifi": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "UNIFI_URL", "-e", "UNIFI_API_KEY", "-e", "UNIFI_USERNAME", "-e", "UNIFI_PASSWORD", "ghcr.io/mattoddie/unifi-mcp:0.9.1" ], "env": { "UNIFI_URL": "your-value", "UNIFI_API_KEY": "your-value", "UNIFI_USERNAME": "your-value", "UNIFI_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For UNIFI_API_KEY, UNIFI_PASSWORD, UNIFI_URL, UNIFI_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the UniFi tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
docker --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Install Docker Desktop: on Mac open Docker.dmg and drag the icon to Applications (pick Apple silicon or Intel to match your Mac) · on Windows double-click Docker Desktop Installer.exe · then open the Docker Desktop app and leave it running. No curl command needed
Open the Docker download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: docker --version
Install once; it works for everything that needs Docker
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
UNIFI_URL Address of your UniFi console. For a legacy self-hosted Network application, include the port.UNIFI_USERNAME A local (not Ubiquiti cloud) account, used instead of an API key. Required for legacy controllers.Descriptions are as written by the maker.
In the UniFi settings, UNIFI_API_KEY, UNIFI_PASSWORD, UNIFI_URL, UNIFI_USERNAME is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use UniFi and tell me what you can do for me, then show me one thing✓ If Cursor says it is using UniFi or shows a UniFi tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
MCP_TRANSPORT The image serves HTTP by default; this runs it over stdio. · default stdioUNIFI_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. · default defaultUNIFI_ALLOW_WRITES Allow changes: restart devices, block clients, edit WiFi, firewall and networks. Off means read-only. · default falseUNIFI_ALLOW_DELETES Also allow deleting configuration and forgetting clients. Needs UNIFI_ALLOW_WRITES. · default falseUNIFI_ALLOW_SECRETS Allow unredacted passwords and keys (include_secrets) and the WiFi QR tool. Off keeps all output redacted. · default falseUNIFI_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.Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a UniFi key (create it on the maker’s site) · 2 setting(s) to fill in (UNIFI_URL, UNIFI_USERNAME) · Install Docker on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server UniFi for VS Code on this computer, in this order: 1) Check Docker with docker --version. If it is missing, tell me to install it from https://www.docker.com/products/docker-desktop/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "unifi": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "UNIFI_URL", "-e", "UNIFI_API_KEY", "-e", "UNIFI_USERNAME", "-e", "UNIFI_PASSWORD", "ghcr.io/mattoddie/unifi-mcp:0.9.1" ], "env": { "UNIFI_URL": "your-value", "UNIFI_API_KEY": "your-value", "UNIFI_USERNAME": "your-value", "UNIFI_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For UNIFI_API_KEY, UNIFI_PASSWORD, UNIFI_URL, UNIFI_USERNAME, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the UniFi tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
docker --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Install Docker Desktop: on Mac open Docker.dmg and drag the icon to Applications (pick Apple silicon or Intel to match your Mac) · on Windows double-click Docker Desktop Installer.exe · then open the Docker Desktop app and leave it running. No curl command needed
Open the Docker download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: docker --version
Install once; it works for everything that needs Docker
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
UNIFI_URL Address of your UniFi console. For a legacy self-hosted Network application, include the port.UNIFI_USERNAME A local (not Ubiquiti cloud) account, used instead of an API key. Required for legacy controllers.Descriptions are as written by the maker.
In the UniFi settings, UNIFI_API_KEY, UNIFI_PASSWORD, UNIFI_URL, UNIFI_USERNAME is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use UniFi and tell me what you can do for me, then show me one thing✓ If VS Code says it is using UniFi or shows a UniFi tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
MCP_TRANSPORT The image serves HTTP by default; this runs it over stdio. · default stdioUNIFI_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. · default defaultUNIFI_ALLOW_WRITES Allow changes: restart devices, block clients, edit WiFi, firewall and networks. Off means read-only. · default falseUNIFI_ALLOW_DELETES Also allow deleting configuration and forgetting clients. Needs UNIFI_ALLOW_WRITES. · default falseUNIFI_ALLOW_SECRETS Allow unredacted passwords and keys (include_secrets) and the WiFi QR tool. Off keeps all output redacted. · default falseUNIFI_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.Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user unifi --env UNIFI_URL=your-value --env UNIFI_API_KEY=your-value --env UNIFI_USERNAME=your-value --env UNIFI_PASSWORD=your-value -- docker run -i --rm -e UNIFI_URL -e UNIFI_API_KEY -e UNIFI_USERNAME -e UNIFI_PASSWORD ghcr.io/mattoddie/unifi-mcp:0.9.1Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"unifi": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"UNIFI_URL",
"-e",
"UNIFI_API_KEY",
"-e",
"UNIFI_USERNAME",
"-e",
"UNIFI_PASSWORD",
"ghcr.io/mattoddie/unifi-mcp:0.9.1"
],
"env": {
"UNIFI_URL": "your-value",
"UNIFI_API_KEY": "your-value",
"UNIFI_USERNAME": "your-value",
"UNIFI_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"unifi": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"UNIFI_URL",
"-e",
"UNIFI_API_KEY",
"-e",
"UNIFI_USERNAME",
"-e",
"UNIFI_PASSWORD",
"ghcr.io/mattoddie/unifi-mcp:0.9.1"
],
"env": {
"UNIFI_URL": "your-value",
"UNIFI_API_KEY": "your-value",
"UNIFI_USERNAME": "your-value",
"UNIFI_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"unifi": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"UNIFI_URL",
"-e",
"UNIFI_API_KEY",
"-e",
"UNIFI_USERNAME",
"-e",
"UNIFI_PASSWORD",
"ghcr.io/mattoddie/unifi-mcp:0.9.1"
],
"env": {
"UNIFI_URL": "your-value",
"UNIFI_API_KEY": "your-value",
"UNIFI_USERNAME": "your-value",
"UNIFI_PASSWORD": "your-value"
}
}
}
}MCP_TRANSPORT envUNIFI_URL required envUNIFI_API_KEY secret required envUNIFI_USERNAME required envUNIFI_PASSWORD secret required envUNIFI_TLS_FINGERPRINT envUNIFI_VERIFY_SSL envUNIFI_SITE envUNIFI_ALLOW_WRITES envUNIFI_ALLOW_DELETES envUNIFI_ALLOW_SECRETS envUNIFI_TOOLSETS envUNIFI_RAW_ALLOWED_PATHS envUNIFI_AUDIT_LOG envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
oci: ghcr.io/mattoddie/unifi-mcp:0.9.1mcpb: …/unifi-mcp-0.9.1-darwin-arm64.mcpbmcpb: …/unifi-mcp-0.9.1-darwin-amd64.mcpbBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account mattoddie, which owns the repo
Code last changed 2 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked: only npm and PyPI packages with a version can be checked
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/mattoddie-unifi-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: UNIFI_API_KEY, UNIFI_PASSWORD
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 2 days ago, and the latest version (0.9.1) reached the registry 2 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Docker, MCPB on your computer.
In the same category: GitHits, Dependency Management MCP Server, Snyk MCP, TokenSafe, Draugr
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Search public open-source code, documentation, metadata, vulnerabilities, changelogs, and examples.
Sonatype component intelligence: versions, security analysis, and Trust Score recommendations
Easily find and fix security issues in your applications leveraging Snyk platform capabilities.
Security scanning for AI agents: SAST, SCA, secrets, IaC, DAST, ranked by real risk.
| This one UniFi | GitHits | Dependency Management MCP Server | Snyk MCP | TokenSafe | Draugr | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Cloud or install on your computer | Runs in the cloud, nothing to install | Installs on your computer | Cloud or install on your computer | Installs on your computer |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 5/5 | 3/4 | 3/3 | 5/5 | 3/3 |
| License | MIT | Apache-2.0 | – | Apache-2.0 | MIT | Apache-2.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Talk to your UniFi network.
An open-source Model Context Protocol server for Ubiquiti UniFi Network. It lets Claude and other AI assistants monitor and manage your sites, devices, clients, WiFi, firewall and more, all from one Docker container.
[unifi-mcp.mattoddie.dev](https://unifi-mcp.mattoddie.dev)
Quick start · Documentation · Tool reference · Contributing
"Why is the lounge TV buffering?"
*The TV is on the Lounge AP at -78 dBm and 12 Mbps, and that AP's 5 GHz radio is at 81% channel utilisation on channel 36. Moving the AP to channel 149 or adding a wired backhaul should fix it. Want me to change the channel?*
Ask about your network in plain English. The assistant picks from 148 tools to look things up and, if you allow it, make changes. Some examples:
ghcr.io/mattoddie/unifi-mcp, about 22 MB) for linux/amd64 and linux/arm64. It serves Streamable HTTP for a long-running service, or stdio for docker run -i. For Claude Desktop there's also a one-click extension bundle (.mcpb) that needs no Docker, and each release has plain binaries for macOS, Linux and Windows on amd64 and arm64.dry_run: true to show the request it would send, with a field-level diff of what would change, without changing anything. UNIFI_AUDIT_LOG records each change in a JSON Lines audit log.You need Docker, a UniFi controller and an MCP client such as Claude Code.
1. Get credentials. On a UniFi OS console, create an API key: UniFi Network → Settings → Control Plane → Integrations → Create API Key. On older controllers, use a local account instead.
2. Start the server.
mkdir unifi-mcp && cd unifi-mcp
curl -fsSLO https://raw.githubusercontent.com/mattoddie/unifi-mcp/main/compose.yaml curl -fsSL https://raw.githubusercontent.com/mattoddie/unifi-mcp/main/example.env -o .env
openssl rand -hex 32).docker compose up -d
3. Connect your assistant.
claude mcp add --transport http unifi http://<docker-host>:8080/mcp \
--header "Authorization: Bearer "
Now ask *"How's my network doing?"* in Claude Code.
Using Claude Desktop, VS Code, Cursor or Codex? See Connecting MCP clients. Prefer not to run a service? Use stdio mode with docker run -i, or a release binary without Docker. On macOS or Linux: brew install mattoddie/tap/unifi-mcp.
On a Mac or Windows PC with Claude Desktop, you don't need Docker at all. Download the .mcpb bundle for your computer from the latest release, open it, and enter your controller URL, API key and certificate fingerprint in the settings. See Claude Desktop.
unifi-mcp is also listed in the MCP Registry as io.github.mattoddie/unifi-mcp, with the image (over stdio) and the bundles, so clients and directories that read the registry can install it.
Out of the box the assistant can look but not touch. To let it make changes, add these to .env and run docker compose up -d:
UNIFI_ALLOW_WRITES=true # restart devices, block clients, edit WiFi/firewall/networks…
UNIFI_ALLOW_DELETES=true # also allow deleting configuration, forgetting clients… (needs writes too) UNIFI_TOOLSETS=overview,devices,clients,wifi,monitoring # optional: expose fewer tools UNIFI_AUDIT_LOG=stderr # optional: log every change (or a file path; see docs/configuration.md)
Ask for a dry run to preview a change first: *"Dry run: disable the guest WiFi. What would change?"* Read Security before turning on writes for a production network.
| Toolset | What's covered |
|---|---|
overview | Sites, controller info, site health |
devices | Device status and details, restart/locate/provision, firmware upgrades (also rolling), radios, PoE outlets, adoption, RF scans, AP groups |
clients | Online and known clients, block/unblock, reconnect, names, fixed IPs, lock to an AP, forget |
switching | Switch ports, port profiles, PoE power-cycling, port mirroring, link aggregation, LLDP neighbours |
wifi | WLANs (SSIDs, security, VLANs, bands), WiFi QR codes |
networks | Networks/VLANs and DHCP, WAN, local DNS records, bandwidth profiles, dynamic DNS |
firewall | Port forwards, firewall rules and groups, zone-based policies and zones, traffic rules, QoS rules, NAT rules, switch ACL rules, object-oriented network policies |
routing | Static routes, policy-based traffic routes |
security | IDS/IPS threat management, threat log, country blocking, content filtering |
vpn | VPN servers and site-to-site VPNs, RADIUS profiles and accounts |
hotspot | Vouchers, hotspot operators, guest authorization, guest portal |
monitoring | Events, alarms, traffic reports, traffic flows, DPI, speed tests, rogue APs, system log, sessions, anomalies, dashboards |
admin | Site settings (including SNMP, mDNS and auto-backup), admins, backups, controller updates, sites |
raw | An escape hatch that calls any controller API path |
See the [tool reference](docs/tools.md) for every tool and argument. Ready-made prompts like network_health_check, troubleshoot_client and security_review chain the tools together for common jobs.
The docs are also published at [unifi-mcp.mattoddie.dev/docs](https://unifi-mcp.mattoddie.dev/docs/), with search.
| 🚀 Getting started | Step-by-step setup, from credentials to first question |
| 🔌 Connecting MCP clients | Claude Code, Claude Desktop, VS Code, Cursor, Codex, stdio mode |
| ⚙️ Configuration | Every environment variable, Docker secrets, toolsets |
| 🐳 Deployment | Compose, image tags, upgrades, TLS reverse proxy, hardening |
| 💬 Using unifi-mcp | Example conversations, prompts, how saves and secrets work |
| 🧰 Tool reference | All 148 tools and 5 prompts, generated from the code |
| 🛡️ Security | Threat model, least privilege, safe write setups |
| 📡 Compatibility | Supported controllers and versions, API caveats |
| 🩹 Troubleshooting | Common errors and how to fix them |
| 🛠️ Development | Architecture, adding a tool, testing |
Contributions are very welcome, whether that's bug reports, compatibility reports from your hardware, docs or new tools. Read the contributing guide to get started, and please follow the code of conduct. To report a vulnerability, see the security policy. Please don't open a public issue for one.
MIT © Matt Oddie
*unifi-mcp is an independent community project. It is not affiliated with, endorsed by or sponsored by Ubiquiti Inc. UniFi and Ubiquiti are trademarks of Ubiquiti Inc.*