Frigate MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Frigate MCP Servershow me recent motion events from the front door camera"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Frigate MCP Server
A Model Context Protocol (MCP) server for Frigate NVR, enabling AI assistants to interact with your Frigate security camera system.
š Features
Camera Management: List and monitor all configured cameras
Event Detection: Query detection events with filtering by camera, object type, and time
Live Snapshots: Get current or historical camera snapshots
Recordings: Access recording summaries and segments
System Stats: Monitor Frigate performance, detector speed, and camera FPS
Configuration: Retrieve complete Frigate configuration
Related MCP server: OBSBOT Camera MCP Server
š Prerequisites
Python 3.10 or higher
A running Frigate NVR instance
Access to the Frigate HTTP API
š Installation
1. Clone the repository
git clone https://github.com/yourusername/frigate-mcp.git
cd frigate-mcp2. Create a virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate3. Install dependencies
pip install -e .4. Configure environment
Create a .env file in the project root:
# Required: URL of your Frigate instance
FRIGATE_FRIGATE_URL=http://localhost:5000
# Optional: API key if authentication is required
# FRIGATE_API_KEY=your_secret_key_here
# Optional: HTTP timeout in seconds (default: 30)
# FRIGATE_TIMEOUT=30š§ Configuration
The server uses environment variables for configuration. You can set them in:
.envfile (recommended for development)Environment variables (recommended for production)
Configuration Options
Variable | Description | Default | Required |
| Base URL of Frigate instance |
| No |
| API key for authentication | None | No |
| HTTP request timeout (seconds) |
| No |
| Server host for SSE/HTTP modes |
| No |
| Server port for SSE/HTTP modes |
| No |
Example Configurations
Local Frigate instance:
FRIGATE_FRIGATE_URL=http://localhost:5000Remote Frigate with authentication:
FRIGATE_FRIGATE_URL=http://192.168.1.100:5000
FRIGATE_API_KEY=your_secret_key
FRIGATE_TIMEOUT=60šÆ Usage
The server supports three operational modes:
1. STDIO Mode (Default)
For direct integration with MCP clients like Claude Desktop:
python -m frigate_mcp.server
# or
frigate-mcp2. SSE Mode (Server-Sent Events)
For web-based clients with real-time updates:
frigate-mcp-sseThe server will start at http://localhost:8000/sse (configurable via environment variables).
Features:
Real-time event streaming
WebSocket-like experience over HTTP
Easy to debug in browser dev tools
Compatible with web applications
3. HTTP Mode (REST API)
For production deployments and API access:
STDIO Mode (for MCP clients):
python -m frigate_mcp.serverSSE Mode (for web clients):
frigate-mcp-sseHTTP Mode (for REST API):
frigate-mcp-httpIntegrating with MCP Clients
Claude Desktop (STDIO Mode)
Testing the Connection
Run the included test script to verify your Frigate connection:
python test_connection.pyExpected output:
============================================================
Frigate MCP Server - Connection Test
============================================================
š§ Frigate Configuration:
URL: http://localhost:5000
API URL: http://localhost:5000/api
Timeout: 30s
š¹ Testing /api/config (cameras)...
ā
Found 1 camera(s)
- front_door: enabled
š Testing /api/stats...
ā
Frigate version: 0.16.3
ā
Detectors: ['coral']
ā
Active cameras: ['front_door']
...Running the MCP Server
Start the server in stdio mode (for MCP clients):
python -m frigate_mcp.serverClaude Desktop (STDIO Mode)
Add to your MCP client configuration (e.g., Claude Desktop config.json):
{
"mcpServers": {
"frigate": {
"command": "/path/to/frigate-mcp/.venv/bin/python",
"args": ["-m", "frigate_mcp.server"],
"env": {
"FRIGATE_FRIGATE_URL": "http://localhost:5000"
}
}
}
}Web Clients (SSE Mode)
Connect to the SSE endpoint for real-time updates:
const eventSource = new EventSource('http://localhost:8000/sse');
eventSource.onmessage = (event) => {
const data = JSON.parse(event.data);
console.log('Received:', data);
};REST API (HTTP Mode)
Make standard HTTP requests:
# Get cameras
curl http://localhost:8000/tools/get_cameras
# Get events
curl http://localhost:8000/tools/get_events?limit=5
# Get stats
curl http://localhost:8000/tools/get_statsOr use any HTTP client:
import requests
response = requests.post(
'http://localhost:8000/tools/get_events',
json={'camera': 'front_door', 'limit': 10}
)
print(response.json()) "frigate": {
"command": "/path/to/frigate-mcp/.venv/bin/python",
"args": ["-m", "frigate_mcp.server"],
"env": {
"FRIGATE_FRIGATE_URL": "http://localhost:5000"
}
}
}
}š ļø Available Tools
The server provides 7 MCP tools for interacting with Frigate:
1. get_cameras()
List all configured cameras with their status and properties.
Returns:
[
{
"name": "front_door",
"enabled": true,
"width": 1920,
"height": 1080,
"fps": 5
}
]2. get_events(camera, label, limit)
Get recent detection events with optional filtering.
Parameters:
camera(optional): Filter by camera namelabel(optional): Filter by object type (person,car,dog, etc.)limit(default: 10): Maximum events to return (1-100)
Example:
get_events(camera="front_door", label="person", limit=5)Returns:
[
{
"id": "1234567890.123456-abcdef",
"camera": "front_door",
"label": "person",
"start_time": 1704067200.5,
"end_time": 1704067205.8,
"has_clip": true,
"has_snapshot": true,
"zones": ["entrance"],
"thumbnail": "http://localhost:5000/api/events/1234.../thumbnail.jpg"
}
]3. get_stats()
Get Frigate system statistics and performance metrics.
Returns:
{
"service": {
"uptime": 86400,
"version": "0.16.3",
"storage": {...}
},
"detectors": {
"coral": {
"inference_speed": 8.5,
"detection_start": 1704067200.0
}
},
"cameras": {
"front_door": {
"camera_fps": 5.0,
"process_fps": 5.0,
"detection_fps": 1.2
}
}
}4. get_event_details(event_id)
Get comprehensive details about a specific event.
Parameters:
event_id: Unique event identifier
Returns:
{
"id": "1234567890.123456-abcdef",
"camera": "front_door",
"label": "person",
"start_time": 1704067200.5,
"end_time": 1704067205.8,
"duration": 5.3,
"score": 0.87,
"zones": ["entrance"],
"has_clip": true,
"has_snapshot": true,
"media": {
"thumbnail": "http://localhost:5000/api/events/.../thumbnail.jpg",
"snapshot": "http://localhost:5000/api/events/.../snapshot.jpg",
"clip": "http://localhost:5000/api/events/.../clip.mp4"
}
}5. get_snapshot(camera, timestamp)
Get a snapshot URL from a specific camera.
Parameters:
camera: Camera nametimestamp(optional): Unix timestamp for historical snapshot
Returns:
{
"camera": "front_door",
"timestamp": "latest",
"url": "http://localhost:5000/api/front_door/latest.jpg",
"description": "Snapshot from front_door (latest)"
}6. get_recordings(camera, date)
Get recording information for a specific camera and date.
Parameters:
camera: Camera namedate(optional): Date inYYYY-MM-DDformat (defaults to today)
Returns:
{
"camera": "front_door",
"date": "2024-01-01",
"recordings_count": 24,
"total_duration": 86400,
"recordings": [
{
"day": "2024-01-01",
"hour": "10",
"duration": 3600,
"events": 5
}
]
}7. get_config()
Get Frigate configuration summary.
Returns:
{
"cameras": ["front_door", "backyard", "garage"],
"detectors": ["coral"],
"mqtt": {
"enabled": true,
"host": "localhost"
},
"model": "path/to/model.tflite",
"version": "0.16.3"
}šļø Project Structure
frigate-mcp/
āāā src/
ā āāā frigate_mcp/
ā āāā __init__.py # Package metadata
ā āāā config.py # Configuration management
ā āāā server.py # MCP server & tools
āāā test_connection.py # Connection test script
āāā pyproject.toml # Project dependencies
āāā .env # Environment variables (not in git)
āāā README.md # This fileMade with ā¤ļø for the Frigate and MCP communities
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceEnables comprehensive control and monitoring of Home Assistant smart home devices, automations, scenes, and system management through AI assistants. Supports lights, climate, media players, notifications, history tracking, and advanced automation workflows.Last updated202MIT
- AlicenseBqualityDmaintenanceEnables PTZ camera control with gimbal positioning, snapshots, and AI visual analysis for OBSBOT and UVC cameras. Supports autonomous scanning patterns and integrates with vision-language models for real-time camera analysis.Last updated71MIT
- Alicense-qualityDmaintenanceEnables AI assistants to interact with Home Assistant smart home devices through natural language. Control devices, manage automations, query entity states, and retrieve historical data across your home automation system.Last updated1MIT
- Alicense-qualityBmaintenanceEnables AI assistants to interact with Home Assistant to control smart home devices, query entity states, and manage automations using natural language. It provides over 90 tools for comprehensive system management, including dashboard configuration, service execution, and automation debugging.Last updatedMIT
Related MCP Connectors
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Transform video, audio and images, and generate media from prompts. FFmpeg, captions, models.
List, configure, chat with, analyse and embed your Echo AI assistants.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/dedsxc/mcp-frigate'
If you have feedback or need assistance with the MCP directory API, please join our Discord server