# unifi-mcp-server

> An MCP server that leverages official UniFi API

- **URL**: https://www.freshcrate.ai/projects/unifi-mcp-server
- **Author**: enuno
- **Category**: MCP Servers
- **Latest version**: `v0.2.6` (2026-05-04)
- **License**: Apache-2.0
- **Source**: https://github.com/enuno/unifi-mcp-server
- **Language**: Python
- **GitHub**: 103 stars, 21 forks
- **Registry**: github
- **Tags**: `python`

## Description

An MCP server that leverages official UniFi API

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.2.6` | 2026-05-04 | High | ## What's Changed  - fix(style): reformat code with black and isort for CI compliance (14cf53e) - fix(tests): update assertions for normalized API response format (ec7ee90) - fix(#75): handle empty vlan field in Network model (015b4fd) - fix(types): various mypy fixes (casts, annotations, payload typing, signature Optionals) (9fa19ea) - fix(types): annotate safe payloads, match_criteria and use cast for SiteManager responses; adjust Redis typing (d0cbace) - fix(types): tighten site_manager fallb |
| `v0.2.5` | 2026-05-01 | High | ## What's Changed  - chore: bump version to 0.2.5 and add comprehensive release notes (e0997da) - feat: add SSE/HTTP transport mode support for MCP gateway integration (58e6a27) - style: automated formatting pass across src/ and tests/ (2183888) - fix(tools): resolve local API bugs reported in #57 (5c18c9e) - chore(deps): bump the uv group across 1 directory with 8 updates (#65) (f06a0ee) - fix: cloud-ea API compatibility and Site Manager endpoint hardening (d021b7f) - feat(main): register switc |
| `v0.2.4` | 2026-02-20 | Low | ## What's Changed  - docs: update README version notice to v0.2.4 (a2923dd) - fix: resolve ImportError cannot import config from agnost on startup (#42) (#43) (6ff0f7c)  **Full Changelog**: https://github.com/enuno/unifi-mcp-server/compare/v0.2.3...v0.2.4  ## Docker Image  Multi-architecture support: amd64, arm64, arm/v7, arm64/v8  ```bash docker pull ghcr.io/enuno/unifi-mcp-server:v0.2.4 ```  ## Installation  ### Via pip  ```bash pip install unifi-mcp-server==v0.2.4 ```  ### Via uv  ```bash uv |
| `v0.2.3` | 2026-02-18 | Low | ## What's Changed  - docs: add v0.2.3 release notes for P2 RADIUS CRUD additions (659a14d) - feat(radius): complete CRUD for RADIUS accounts and hotspot packages (#41) (fa4f0d1) - docs: add v0.2.3 release notes to CHANGELOG.md (#40) (c72542f) - fix(p1): Fix runtime bugs and missing API client methods in P1 features (#39) (99c578e) - fix(security): Address CVE-2025-69872 + Add Site Manager API Foundation (P0) (#37) (1e99a6f) - docs(plan): update DEVELOPMENT_PLAN.md with newly documented API endpo |
| `v0.2.2` | 2026-02-16 | Low | ## What's Changed  - docs: add v0.2.2 release notes to CHANGELOG.md (14f6a9f) - docs: update documentation for v0.2.2 release (ffc1e6e) - style: fix isort import ordering in test_port_profile_tools.py (5674286) - fix(deps): update dependencies to address security vulnerabilities (ddaa9e9) - style: apply black and isort formatting fixes (9feb15b) - fix: address code review findings across four areas (e77129c) - fix(tools): validate port profile responses through Pydantic models (d666965) - fix(ty |
| `v0.2.1` | 2026-01-26 | Low | ## What's Changed  - fix: exclude integration test runner from pytest naming check (893561e) - fix: update test_harness.py with modern Python type annotations (8b9440a) - fix: configure pytest to properly exclude integration tests from unit test runs (be2d092) - fix: resolve CI/CD test failures for v0.2.1 release (7a8450b) - chore: bump version to 0.2.1 (5f8476d) - fix: topology tools + integration test framework (v0.2.1) (beed7d4) - fix: handle list responses in resolve_site_id for local API (8 |
| `v0.2.0` | 2026-01-25 | Low | ## What's Changed  - fix: update author email to valid address for PyPI compliance (da25ead) - chore: prepare for PyPI release v0.2.0 (3226ff9) - docs: enhance MCP client configs, extract release process, remove submodule (f453b7c) - docs: close v0.2.0 release session with comprehensive summary (4388896) - chore: ignore MCP registry authentication tokens\n\n🤖 Generated with [Nori](https://nori.ai)\n\nCo-Authored-By: Nori <contact@tilework.tech> (e37ef2e) - docs: update RELEASE_COMPLETION_GUIDE |
| `v0.1.4` | 2025-11-17 | Low | ## 🔄 Version Correction Notice  This release contains the same code as v0.2.0, which was published prematurely on 2025-11-17. v0.1.4 is the correct version number for this release. Please use v0.1.4 instead of v0.2.0.  The true v0.2.0 release is planned for Q1 2025 and will include: - Complete Zone-Based Firewall (ZBF) implementation - Full Traffic Flow monitoring - Advanced QoS and traffic management - Backup and restore operations - 80%+ test coverage  See [DEVELOPMENT_PLAN.md](https://github |
| `v0.1.2` | 2025-10-20 | Low | ## What's Changed  - fix(docker): add mcp.run() call and update Docker instructions (41f3cfe)  **Full Changelog**: https://github.com/enuno/unifi-mcp-server/compare/v0.1.1...v0.1.2  ## Docker Image  ```bash docker pull ghcr.io/enuno/unifi-mcp-server:v0.1.2 ```  ## Installation  ### Via pip  ```bash pip install unifi-mcp-server==v0.1.2 ```  ### Via uv  ```bash uv pip install unifi-mcp-server==v0.1.2 ``` |
| `v0.1.1` | 2025-10-20 | Low | ## What's Changed  - fix(security): update secrets baseline to include false positives (fec7965) - fix(ci): resolve pre-commit hook failures and FastMCP initialization (f7e2663) - Updating README.md (c258f70) - Updating README.md (8bc6df4) - fix(security): install OSV scanner binary directly instead of using action (e4cab65)  **Full Changelog**: https://github.com/enuno/unifi-mcp-server/compare/v0.1.0...v0.1.1  ## Docker Image  ```bash docker pull ghcr.io/enuno/unifi-mcp-server:v0.1.1 ```  ## In |

## Citation

- HTML: https://www.freshcrate.ai/projects/unifi-mcp-server
- Markdown: https://www.freshcrate.ai/projects/unifi-mcp-server.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/unifi-mcp-server/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._