Skip to main content
Glama
Sign In
overseerr-mcp

overseerr-mcp

by Milli42
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • arrstack-mcp

      CT4nk3r
      A
      license
      Not graded
      quality
      A
      maintenance
      An MCP server that gives AI assistants control over your Sonarr, Radarr, Prowlarr, qBittorrent, and Jellyfin homelab media stack.
      8
      MIT

    • overseerr-mcp-server

      ptbsare
      A
      license
      A
      quality
      C
      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
      2
      MIT