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
F
license - not found
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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

  • 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.
    3
    MIT
  • 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
    1
    MIT

View all related MCP servers

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

View all MCP Connectors

Latest Blog Posts

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