UniFi Protect MCP
Manage UniFi Protect cameras, events, recordings, and smart detections via MCP.
io.github.sirkirby/unifi-protect-mcp · Repository · version 0.1.6 · 687 stars · listed from registry
Install
The sweep installs into a clean prefix, but this is the command a user would run:
uvx unifi-protect-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) ---
Building antlr4-python3-runtime==4.9.3
Downloading av (34.1MiB)
Built antlr4-python3-runtime==4.9.3
Downloaded av
Installed 59 packages in 431ms
warning: `unifi-protect-mcp==0.1.6` 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/bqy7HqiLkA1amGkc/bin/unifi-protect-mcp", line 6, in <module>
from unifi_protect_mcp.main import main
File "/home/runner/.cache/uv/archive-v0/bqy7HqiLkA1amGkc/lib/python3.13/site-packages/unifi_protect_mcp/main.py", line 11, in <module>
from unifi_protect_mcp.bootstrap import (
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...<2 lines>...
) # ensures logging/env setup early
^
File "/home/runner/.cache/uv/archive-v0/bqy7HqiLkA1amGkc/lib/python3.13/site-packages/unifi_protect_mcp/bootstrap.py", line 24, 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
Downloading av (17.4MiB)
Built antlr4-python3-runtime==4.9.3
Downloaded av
Installed 59 packages in 560ms
warning: `unifi-protect-mcp==0.1.6` 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/6pNVKAXsCRLQzCoI/bin/unifi-protect-mcp", line 6, in <module>
from unifi_protect_mcp.main import main
File "/Users/runner/.cache/uv/archive-v0/6pNVKAXsCRLQzCoI/lib/python3.14/site-packages/unifi_protect_mcp/main.py", line 11, in <module>
from unifi_protect_mcp.bootstrap import (
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...<2 lines>...
) # ensures logging/env setup early
^
File "/Users/runner/.cache/uv/archive-v0/6pNVKAXsCRLQzCoI/lib/python3.14/site-packages/unifi_protect_mcp/bootstrap.py", line 24, 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 av (26.3MiB)
Built antlr4-python3-runtime==4.9.3
Downloaded av
Installed 61 packages in 14.23s
warning: `unifi-protect-mcp==0.1.6` 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\4mEy6LhlnbLUEhMN\Scripts\unifi-protect-mcp.exe\__main__.py", line 4, in <module>
from unifi_protect_mcp.main import main
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\4mEy6LhlnbLUEhMN\Lib\site-packages\unifi_protect_mcp\main.py", line 11, in <module>
from unifi_protect_mcp.bootstrap import (
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
...<2 lines>...
) # ensures logging/env setup early
^
File "C:\Users\runneradmin\AppData\Local\uv\cache\archive-v0\4mEy6LhlnbLUEhMN\Lib\site-packages\unifi_protect_mcp\bootstrap.py", line 24, 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-protect-mcp.html)