UniFi Network MCP
Manage UniFi Network devices, clients, firewall, VLANs, VPNs, and more via MCP.
io.github.sirkirby/unifi-network-mcp · Repository · version 0.7.8 · 687 stars · listed from registry
Install
The sweep installs into a clean prefix, but this is the command a user would run:
uvx unifi-network-mcp
Needs credentials: UNIFI_HOST, UNIFI_USERNAME, UNIFI_PASSWORD. The probe used placeholder values, so an amber needs credentials result below means the server asked for the real ones, not that it is broken. Maintainers: how to go green.
Results by platform
Linux
needs credentials2026-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Downloading cpython-3.13.15-linux-x86_64-gnu (download) (33.2MiB)
Downloaded cpython-3.13.15-linux-x86_64-gnu (download)
Building antlr4-python3-runtime==4.9.3
Downloading aiohttp (1.7MiB)
Downloading pydantic-core (2.0MiB)
Downloaded pydantic-core
Downloaded aiohttp
Built antlr4-python3-runtime==4.9.3
Installed 53 packages in 22ms
warning: `unifi-network-mcp==0.7.8` is yanked (reason: "Broken dependency metadata (unpinned shared/core dep); install fails. Use @latest.")
Traceback (most recent call last):
File "/home/runner/.cache/uv/archive-v0/GF5gdMFNOAajpdh7/bin/unifi-network-mcp", line 6, in <module>
from unifi_network_mcp.main import main
File "/home/runner/.cache/uv/archive-v0/GF5gdMFNOAajpdh7/lib/python3.13/site-packages/unifi_network_mcp/main.py", line 11, in <module>
from unifi_network_mcp.bootstrap import (
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...<2 lines>...
) # ensures logging/env setup early
^
File "/home/runner/.cache/uv/archive-v0/GF5gdMFNOAajpdh7/lib/python3.13/site-packages/unifi_network_mcp/bootstrap.py", line 23, in <module>
from unifi_mcp_shared.config import load_yaml_config # noqa: F401 — re-export for convenience
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'unifi_mcp_shared.config'
macOS
needs credentials2026-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Building antlr4-python3-runtime==4.9.3
Built antlr4-python3-runtime==4.9.3
Installed 53 packages in 184ms
warning: `unifi-network-mcp==0.7.8` is yanked (reason: "Broken dependency metadata (unpinned shared/core dep); install fails. Use @latest.")
Traceback (most recent call last):
File "/Users/runner/.cache/uv/archive-v0/T3aj3--fJwS6JKQA/bin/unifi-network-mcp", line 6, in <module>
from unifi_network_mcp.main import main
File "/Users/runner/.cache/uv/archive-v0/T3aj3--fJwS6JKQA/lib/python3.14/site-packages/unifi_network_mcp/main.py", line 11, in <module>
from unifi_network_mcp.bootstrap import (
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...<2 lines>...
) # ensures logging/env setup early
^
File "/Users/runner/.cache/uv/archive-v0/T3aj3--fJwS6JKQA/lib/python3.14/site-packages/unifi_network_mcp/bootstrap.py", line 23, in <module>
from unifi_mcp_shared.config import load_yaml_config # noqa: F401 — re-export for convenience
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'unifi_mcp_shared.config'
Windows
needs credentials2026-08-16 · probed over pypi1 recorded run, oldest first.
handshake failed: MCP error -32000: Connection closed
--- stderr (tail) ---
Building antlr4-python3-runtime==4.9.3
Downloading pydantic-core (2.0MiB)
Downloading pywin32 (6.6MiB)
Downloaded pydantic-core
Built antlr4-python3-runtime==4.9.3
Downloaded pywin32
Installed 55 packages in 5.33s
warning: `unifi-network-mcp==0.7.8` is yanked (reason: "Broken dependency metadata (unpinned shared/core dep); install fails. Use @latest.")
Traceback (most recent call last):
File "<frozen runpy>", line 203, in _run_module_as_main
File "<frozen runpy>", line 88, in _run_code
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\-_IAPMgxiHv2eTuc\Scripts\unifi-network-mcp.exe\__main__.py", line 4, in <module>
from unifi_network_mcp.main import main
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\-_IAPMgxiHv2eTuc\Lib\site-packages\unifi_network_mcp\main.py", line 11, in <module>
from unifi_network_mcp.bootstrap import (
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...<2 lines>...
) # ensures logging/env setup early
^
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\-_IAPMgxiHv2eTuc\Lib\site-packages\unifi_network_mcp\bootstrap.py", line 23, in <module>
from unifi_mcp_shared.config import load_yaml_config # noqa: F401 � re-export for convenience
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ModuleNotFoundError: No module named 'unifi_mcp_shared.config'
Badge
Paste this into the project README to show the current result:
[](https://doesitinstall.com/s/io.github.sirkirby__unifi-network-mcp.html)