overseerr-mcp
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., "@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 installed
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-qualityBmaintenanceA 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.Last updated4MIT
- Alicense-qualityAmaintenanceAn MCP server that gives AI assistants control over your Sonarr, Radarr, Prowlarr, qBittorrent, and Jellyfin homelab media stack.Last updated3MIT
- Alicense-qualityBmaintenanceFastMCP 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.Last updated1MIT
- Alicense-qualityCmaintenanceSelf-hosted media server with AI-powered management via MCP, providing tools for Jellyfin, Sonarr, Radarr, and download management.Last updated9MIT
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 Flux AI image generation
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/Milli42/overseerr-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server