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
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
- ZapierOAuthcom.zapier
Hosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceA 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.12AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI assistants control over your Sonarr, Radarr, Prowlarr, qBittorrent, and Jellyfin homelab media stack.7MIT
- 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