Overseerr MCP

What is Overseerr MCP?

Overseerr MCP is a Model Context Protocol server that connects Claude AI to your Overseerr media request system. It allows you to search for movies and TV shows, submit media requests, and manage your Overseerr instance using natural language through Claude.

How to use Overseerr MCP?

Install dependencies with pnpm install, build the project with pnpm build, copy .env.template to .env and set OVERSEERR_URL and OVERSEERR_API_KEY, then configure Claude Desktop with a stdio transport pointing to the built server. Start the server with pnpm start. Once connected, Claude can invoke tools like overseerr:search (to search movies, TV shows, or people) and overseerr:request (to request a movie or TV show by TMDB ID, optionally specifying which seasons for TV).

Key features of Overseerr MCP

• Search movies, TV shows, and people with natural language queries.
• Get detailed media info: title, release date, plot, availability, request status.
• Filter searches by media type (movie / TV / person).
• Request movies or TV shows, specifying individual seasons for TV.
• Track request status and receive updates.
• Secure API key handling and rate limiting.

Use cases of Overseerr MCP

• Ask Claude to find recent sci‑fi movies and request the one you like.
• Search for TV shows about a topic (e.g., cooking) and request specific seasons.
• Have Claude manage your Overseerr watchlist by requesting new media conversationally.

FAQ from Overseerr MCP

What are the prerequisites for Overseerr MCP?

You need Node.js, pnpm, Claude Desktop, and a running Overseerr instance.

How do I configure Claude Desktop for Overseerr MCP?

Add a JSON entry to your Claude Desktop config file with command: "node", args pointing to the built server’s index.js, transport: { "type": "stdio" }, and environment variables OVERSEERR_URL and OVERSEERR_API_KEY. Use double backslashes for paths on Windows.

What tools does Overseerr MCP expose?

Two tools: overseerr:search (takes a query and optional type filter) and overseerr:request (takes mediaId, mediaType, and optional seasons array).

How does error handling work?

The server implements API errors with meaningful messages, rate limiting protection, request validation, and connection error recovery.

Where does my data live?

All communication happens over the OpenAI‑style MCP transport; your Overseerr instance and API key are configured locally via environment variables.