overseerr-mcp
Click on "Deploy 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., "@overseerr-mcpsearch for The Matrix and check availability"
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.
overseerr-mcp
MCP server for Overseerr — search, request, and manage media from Hermes Agent.
Tools
Tool | Description |
| Search movies & TV shows (returns TMDB IDs + availability) |
| Full movie details by TMDB ID |
| Full TV show details (seasons, episodes) |
| Submit a request → triggers Radarr/Sonarr pipeline |
| List all pending/processing requests |
| Overseerr version + connection health |
Related MCP server: arrstack-mcp
Quick Start
cp .env.example .env
# Edit .env with your Overseerr URL and API key
docker compose up -dThe server exposes an MCP SSE endpoint at http://localhost:8000/sse.
Connect from Hermes Agent
Add to ~/.hermes/config.yaml:
mcp_servers:
overseerr:
url: "http://192.168.20.79:8053/mcp"
timeout: 60Or via CLI:
hermes config set mcp_servers.overseerr.url "http://192.168.20.79:8053/mcp"
hermes config set mcp_servers.overseerr.timeout 60Then restart Hermes. Tools appear as mcp_overseerr_search, mcp_overseerr_request_media, etc.
Portainer Stack
Paste the contents of docker-compose.yml into Portainer Stacks, or point Portainer at this repo. Create a .env file with your OVERSEERR_API_KEY.
Environment Variables
Variable | Required | Default |
| Yes | — |
| Yes | — |
| No |
|
| No |
|
API Key
Find it in Overseerr: Settings → General → API Key. Base64-encoded string, ~68 chars. The default user ("homelab" on David's instance) needs admin permissions to submit requests.
Manual Run (for testing)
pip install -r requirements.txt
OVERSEERR_URL=http://192.168.20.79:5055 \
OVERSEERR_API_KEY=your-api-key-here \
python server.pyThis server cannot be deployed
Maintenance
Related MCP Connectors
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
MCP server for Google Veo AI video generation
- ZapierOAuthcom.zapier
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceA comprehensive Model Context Protocol server that bridges LLMs with self-hosted media services, enabling natural language control of TV shows, movies, downloads, and notifications while maintaining traditional API access.11AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceAn MCP server that gives AI assistants control over your Sonarr, Radarr, Prowlarr, qBittorrent, and Jellyfin homelab media stack.6MIT
- AlicenseAqualityBmaintenanceFastMCP server to interact with the Overseerr API for movie and TV show requests management, enabling users to request media, search, and manage libraries via natural language.81MIT
- AlicenseNot gradedqualityCmaintenanceSelf-hosted media server with AI-powered management via MCP, providing tools for Jellyfin, Sonarr, Radarr, and download management.9MIT