Skip to main content
Glama
Milli42

overseerr-mcp

by Milli42

overseerr-mcp

MCP server for Overseerr — search, request, and manage media from Hermes Agent.

Tools

Tool

Description

search

Search movies & TV shows (returns TMDB IDs + availability)

get_movie

Full movie details by TMDB ID

get_tv

Full TV show details (seasons, episodes)

request_media

Submit a request → triggers Radarr/Sonarr pipeline

pending_requests

List all pending/processing requests

server_status

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 -d

The 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: 60

Or via CLI:

hermes config set mcp_servers.overseerr.url "http://192.168.20.79:8053/mcp"
hermes config set mcp_servers.overseerr.timeout 60

Then 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

OVERSEERR_URL

Yes

OVERSEERR_API_KEY

Yes

HOST

No

0.0.0.0

PORT

No

8000

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.py

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that gives AI assistants control over your Sonarr, Radarr, Prowlarr, qBittorrent, and Jellyfin homelab media stack.
    6
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    FastMCP 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.
    8
    1
    MIT