seerr-mcp
Configures Discord notification agent settings and allows sending test notifications in Seerr.
Manages Emby integration settings for media server connection within a Seerr instance.
Manages Jellyfin integration settings, including library configuration, user sync, and quick connect authentication in a Seerr instance.
Configures ntfy notification agent settings and allows sending test notifications in Seerr.
Manages Plex integration settings, including library configuration, user sync, and device/server discovery in a Seerr instance.
Configures Pushbullet notification agent settings and allows sending test notifications in Seerr.
Manages Radarr integration settings, including connection, profiles, and testing in a Seerr instance.
Configures Slack notification agent settings and allows sending test notifications in Seerr.
Manages Sonarr integration settings, including connection, profiles, and testing in a Seerr instance.
Configures Telegram notification agent settings and allows sending test notifications in Seerr.
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., "@seerr-mcpCan you search for the new Dune movie and add it to my requests?"
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.
seerr-mcp
Part of the arr-mcps collection. MCP server exposing Seerr's v1 REST API (OpenAPI 3.0.2) as tools, so an LLM can read and manage a Seerr instance: search and discovery, media requests and their approval workflow, users, issues, watchlists and blocklists, Plex/Jellyfin/Emby and Sonarr/Radarr integration settings, notification agents, scheduled jobs, and more. Full surface — reads and writes, with destructive tools flagged.
Built with FastMCP.
Getting an API key
Generate one in Seerr Settings > General. Auth is the X-Api-Key header.
An optional X-API-User header can impersonate a specific user id (defaults
to user 1, the admin account the key belongs to).
Related MCP server: overseerr-mcp-server
Install
Download a wheel from the latest release
and install it as a uv tool (no repo checkout needed):
uv tool install seerr_mcp-*.whlThis puts a seerr-mcp command on your PATH. Register it with Claude Code:
claude mcp add seerr \
--env SEERR_URL=http://your-seerr-host \
--env SEERR_API_KEY=<key> \
-- seerr-mcpFrom source
uv sync
cp .env.example .env # fill in SEERR_URL and SEERR_API_KEYclaude mcp add seerr \
--env SEERR_URL=http://your-seerr-host \
--env SEERR_API_KEY=<key> \
-- uv run --directory /path/to/seerr-mcp seerr-mcpConfig
Env var | Required | Default |
| yes | - |
| yes* | none (no |
| no | none (no |
* Every API endpoint requires auth; practically you must set it, but the server still starts without one so errors surface from the API rather than at startup.
Tools
One tool per Seerr v1 JSON endpoint (208 tools). Naming is
seerr_<verb>_<resource>. GET endpoints are read-only; POST/PUT are writes;
DELETE endpoints are flagged destructive. One exception: GET /settings/discover/reset resets all discover sliders and is therefore marked
a write.
Endpoints are grouped below by the spec's tags. Request bodies are passed as
opaque JSON objects/lists (body argument); see the vendored spec at
tests/data/seerr_openapi.yml for the exact fields each accepts.
Tool | Method | Endpoint |
Public | ||
| GET |
|
| GET |
|
Settings | ||
| GET |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| GET |
|
| GET |
|
| GET |
|
| POST |
|
| GET |
|
| POST |
|
| GET |
|
| GET |
|
| POST |
|
| GET |
|
| GET |
|
| GET |
|
| PUT |
|
| POST |
|
| GET |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| PUT |
|
| DELETE |
|
| GET |
|
| GET |
|
| POST |
|
| POST |
|
| PUT |
|
| DELETE |
|
| GET |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| PUT |
|
| DELETE |
|
| POST |
|
| GET* |
|
| GET |
|
Auth | ||
| GET |
|
| POST |
|
| POST |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| POST |
|
| POST |
|
| POST |
|
Users | ||
| GET |
|
| POST |
|
| PUT |
|
| POST |
|
| POST |
|
| POST |
|
| GET |
|
| GET |
|
| DELETE |
|
| GET |
|
| PUT |
|
| DELETE |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| POST |
|
| GET |
|
| POST |
|
| POST |
|
| DELETE |
|
| POST |
|
| DELETE |
|
| POST |
|
| GET |
|
| POST |
|
| GET |
|
| POST |
|
| GET |
|
Search / Discover | ||
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
Requests | ||
| GET |
|
| POST |
|
| GET |
|
| GET |
|
| PUT |
|
| DELETE |
|
| POST |
|
| POST |
|
Movies | ||
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
TV | ||
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
Media | ||
| GET |
|
| DELETE |
|
| DELETE |
|
| POST |
|
| GET |
|
People | ||
| GET |
|
| GET |
|
Collections | ||
| GET |
|
Services | ||
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
Watchlist | ||
| POST |
|
| DELETE |
|
Blocklist | ||
| GET |
|
| POST |
|
| GET |
|
| DELETE |
|
| POST |
|
| DELETE |
|
TMDB helpers | ||
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
Issues | ||
| GET |
|
| POST |
|
| GET |
|
| GET |
|
| DELETE |
|
| POST |
|
| POST |
|
Issue comments | ||
| GET |
|
| PUT |
|
| DELETE |
|
Keywords | ||
| GET |
|
Watch providers / certifications | ||
| GET |
|
| GET |
|
| GET |
|
| GET |
|
| GET |
|
Override rules | ||
| GET |
|
| POST |
|
| PUT |
|
| DELETE |
|
The deprecated /blacklist/* aliases (sunset 2026-06-01) are intentionally
not wrapped; use the /blocklist/* tools. Auth endpoints (seerr_login_*,
seerr_logout, seerr_request_password_reset) carry credentials or manage
sessions and are rarely needed through MCP when SEERR_API_KEY is already set.
Development
make help # list all commandsCommand | Does |
|
|
| Offline tests - one per endpoint, mocked HTTP |
| Tests against the live instance (needs |
| Build wheel + sdist into |
| Bump the version in |
| Remove build artifacts |
The release workflow (.github/workflows/release.yml) builds and publishes to
Releases whenever a v*
tag is pushed - so the usual flow is make bump-patch, commit, then tag and
push.
The offline suite covers every endpoint (mocked HTTP). The integration suite
exercises GET endpoints against your live instance; POST/PUT/DELETE only run
when SEERR_WRITE_TESTS=1, as a safe create→delete cycle against a scratch
blocklist entry that is cleaned up afterwards.
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
- AlicenseAqualityAmaintenanceEnables AI assistants to interact with Overseerr for automated media discovery, requests, and management in your Plex ecosystem, including searching for movies/TV shows, requesting media, checking request status, and managing approvals.611819MIT
- Alicense-qualityCmaintenanceFastMCP 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.1MIT
- AlicenseAqualityDmaintenanceMCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.12MIT
- Flicense-qualityBmaintenanceMCP server for Overseerr that enables searching, requesting, and managing media (movies and TV shows) through natural language, with integration to Radarr/Sonarr for automated downloads.
Related MCP Connectors
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
MCP server exposing the Backtest360 engine API as tools for AI agents.
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/SavageCore/seerr-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server