seerr-mcp
Allows managing Jellyfin media server configuration within an Overseerr/Jellyseerr instance.
Allows managing Plex media server configuration within an Overseerr/Jellyseerr instance.
Allows managing Radarr service configuration within an Overseerr/Jellyseerr instance.
Allows managing Sonarr service configuration within an Overseerr/Jellyseerr instance.
Click on "Deploy 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-mcp search for the movie Dune and request it"
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 server
Run Overseerr or Jellyseerr from Claude.ai and Claude Code. All 170 operations of the API are tools, generated from Overseerr's own OpenAPI document. Not a curated subset: every endpoint the web interface can reach, this can reach.
Jellyseerr is a fork of Overseerr and keeps the same API, so this works against either. Point SEERR_URL at whichever you run.
Using this server with a paid AI service costs money. Tool definitions and results are billed as input tokens, and an agent can call tools repeatedly on its own. You are responsible for every charge, so set spending limits with your provider. The author accepts no liability for any costs. SeeDISCLAIMER.md.
Why not the other options
Measured against overseerr-api.yml, which has 134 paths and 170 operations:
Server | Overseerr tools | Coverage |
| 9 | 5 % |
| search, availability, request | partial |
| request-centric subsets | partial |
This one | 170 | 100 % |
Every existing server treats Seerr as a request box: search, request, approve. Nothing else exposes the settings tree, user quotas and permissions, issues, the Plex and Sonarr/Radarr service configuration, discovery sliders or the job scheduler.
Related MCP server: seerr-mcp
How it stays complete
src/seerr_mcp/tools.py is generated, not written:
curl -o overseerr-api.yml https://raw.githubusercontent.com/sct/overseerr/develop/overseerr-api.yml
python scripts/convert_spec.py overseerr-api.yml openapi.json
python scripts/generate_tools.py openapi.json src/seerr_mcp/tools.pyA test compares every generated call against every operation in the spec, in both directions. An endpoint Overseerr adds and this misses fails the build; so does a tool pointing at an endpoint the spec does not define.
Tool names
Verb first, derived from the method and path, so the name says what it does:
Pattern | Meaning | Example |
| Read a collection |
|
| Read one record |
|
| POST |
|
| PUT |
|
| DELETE |
|
170 tools is a lot to put in front of a model at once. If your client supports tool filtering, narrow it to the groups you use.
What is covered
Every tag in the spec: public, auth, users, search, request, movies, tv, person, media, collection, service, settings, issue, other. That includes the whole settings tree (Plex, Radarr, Sonarr, Jellyfin, notifications, network, logs, jobs, cache), user permissions and quotas, watchlists, blacklists, discovery sliders and the issue tracker.
Setup
git clone https://github.com/rollecode/seerr-mcp.git
cd seerr-mcp
uv venv && uv pip install -e .export SEERR_URL=http://127.0.0.1:5055
export SEERR_API_KEY=... # Settings, General, API KeyClaude Code
claude mcp add seerr -- /path/to/seerr-mcp/.venv/bin/seerr-mcpWriting records
Settings endpoints replace the whole object, so read the matching list_* first, change the fields you want and send it all back as body.
Hosting it
Running it over HTTP puts it in reach of Claude.ai as a custom connector, and of Claude Code on other machines. Three tiers, the same shape the other servers in this family use:
Tier | Port | What it does |
| 8550 | The server. No login of its own, never exposed |
nginx | 8551 | Front door, behind a Cloudflare Tunnel |
| 8552 | OAuth 2.1 sign-in, or a fixed bearer token |
npm install
node set-password.js 'a password for the sign-in page'
printf 'SEERR_URL=...\n' > ~/.config/seerr-mcp/env
chmod 600 ~/.config/seerr-mcp/envCopy systemd/*.service into /etc/systemd/system/, replacing YOUR_USER and the ISSUER hostname, then:
sudo systemctl enable --now seerr-mcp seerr-mcp-authPoint nginx/seerr-mcp.conf at your own hostname and send the tunnel at 127.0.0.1:8551.
Environment the server itself reads: SEERR_URL, SEERR_API_KEY. The sign-in page carries the Overseerr or Jellyseerr mark and accent colour, set through APP_NAME, APP_ACCENT and APP_BLURB in the auth unit.
Claude.ai
Settings, Connectors, Add custom connector, URL https://seerr-mcp.your-domain/mcp, client ID and secret blank. The sign-in page asks for the password set above. Connectors belong to the account, so adding it once covers mobile too.
Development
uv pip install -e . pytest ruff
.venv/bin/python -m pytest tests
.venv/bin/ruff check .Available Tools
171 toolscreate_auth_localAIdempotent
Sign in using a local account.
POST /api/v1/auth/local
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_auth_logoutAIdempotent
Sign out and clear session cookie.
POST /api/v1/auth/logout
Inputs: no named parameters. Returns: result
create_auth_plexAIdempotent
Sign in using a Plex token.
POST /api/v1/auth/plex
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_auth_reset_passwordBIdempotent
Send a reset password email.
POST /api/v1/auth/reset-password
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_auth_reset_password_by_guidAIdempotent
Reset the password for a user.
POST /api/v1/auth/reset-password/{guid}
Args: guid: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), guid (required). Returns: result
create_issueCIdempotent
Create new issue.
POST /api/v1/issue
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_issue_by_issue_id_by_statusAIdempotent
Update an issue's status.
POST /api/v1/issue/{issueId}/{status}
Args: issue_id: Issue ID status: New status
Inputs: status (required), issue_id (required). Returns: result
create_issue_by_issue_id_commentBIdempotent
Create a comment.
POST /api/v1/issue/{issueId}/comment
Args: issue_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), issue_id (required). Returns: result
create_media_by_media_id_by_statusAIdempotent
Update media status.
POST /api/v1/media/{mediaId}/{status}
Args: media_id: Media ID status: New status body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), status (required), media_id (required). Returns: result
create_requestCIdempotent
Create new request.
POST /api/v1/request
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_request_by_request_id_by_statusBIdempotent
Update a request's status.
POST /api/v1/request/{requestId}/{status}
Args: request_id: Request ID status: New status
Inputs: status (required), request_id (required). Returns: result
create_request_by_request_id_retryBIdempotent
Retry failed request.
POST /api/v1/request/{requestId}/retry
Args: request_id: Request ID
Inputs: request_id (required). Returns: result
create_settings_cache_by_cache_id_flushCIdempotent
Flush a specific cache.
POST /api/v1/settings/cache/{cacheId}/flush
Args: cache_id: Path parameter.
Inputs: cache_id (required). Returns: result
create_settings_discoverAIdempotent
Batch update all sliders.
POST /api/v1/settings/discover
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_discover_addAIdempotent
Add a new slider.
POST /api/v1/settings/discover/add
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_initializeBIdempotent
Initialize application.
POST /api/v1/settings/initialize
Inputs: no named parameters. Returns: result
create_settings_jobs_by_job_id_cancelBIdempotent
Cancel a specific job.
POST /api/v1/settings/jobs/{jobId}/cancel
Args: job_id: Path parameter.
Inputs: job_id (required). Returns: result
create_settings_jobs_by_job_id_runBIdempotent
Invoke a specific job.
POST /api/v1/settings/jobs/{jobId}/run
Args: job_id: Path parameter.
Inputs: job_id (required). Returns: result
create_settings_jobs_by_job_id_scheduleAIdempotent
Modify job schedule.
POST /api/v1/settings/jobs/{jobId}/schedule
Args: job_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), job_id (required). Returns: result
create_settings_mainAIdempotent
Update main settings.
POST /api/v1/settings/main
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_main_regenerateAIdempotent
Get main settings with newly-generated API key.
POST /api/v1/settings/main/regenerate
Inputs: no named parameters. Returns: result
create_settings_notifications_discordAIdempotent
Update Discord notification settings.
POST /api/v1/settings/notifications/discord
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_discord_testCIdempotent
Test Discord settings.
POST /api/v1/settings/notifications/discord/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_emailAIdempotent
Update email notification settings.
POST /api/v1/settings/notifications/email
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_email_testBIdempotent
Test email settings.
POST /api/v1/settings/notifications/email/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_gotifyBIdempotent
Update Gotify notification settings.
POST /api/v1/settings/notifications/gotify
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_gotify_testCIdempotent
Test Gotify settings.
POST /api/v1/settings/notifications/gotify/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_lunaseaCIdempotent
Update LunaSea notification settings.
POST /api/v1/settings/notifications/lunasea
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_lunasea_testCIdempotent
Test LunaSea settings.
POST /api/v1/settings/notifications/lunasea/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_pushbulletAIdempotent
Update Pushbullet notification settings.
POST /api/v1/settings/notifications/pushbullet
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_pushbullet_testBIdempotent
Test Pushbullet settings.
POST /api/v1/settings/notifications/pushbullet/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_pushoverAIdempotent
Update Pushover notification settings.
POST /api/v1/settings/notifications/pushover
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_pushover_testBIdempotent
Test Pushover settings.
POST /api/v1/settings/notifications/pushover/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_slackAIdempotent
Update Slack notification settings.
POST /api/v1/settings/notifications/slack
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_slack_testCIdempotent
Test Slack settings.
POST /api/v1/settings/notifications/slack/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_telegramAIdempotent
Update Telegram notification settings.
POST /api/v1/settings/notifications/telegram
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_telegram_testCIdempotent
Test Telegram settings.
POST /api/v1/settings/notifications/telegram/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_webhookBIdempotent
Update webhook notification settings.
POST /api/v1/settings/notifications/webhook
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_webhook_testAIdempotent
Test webhook settings.
POST /api/v1/settings/notifications/webhook/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_webpushCIdempotent
Update Web Push notification settings.
POST /api/v1/settings/notifications/webpush
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_notifications_webpush_testBIdempotent
Test Web Push settings.
POST /api/v1/settings/notifications/webpush/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_plexAIdempotent
Update Plex settings.
POST /api/v1/settings/plex
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_plex_syncAIdempotent
Start full Plex library scan.
POST /api/v1/settings/plex/sync
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_radarrCIdempotent
Create Radarr instance.
POST /api/v1/settings/radarr
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_radarr_testAIdempotent
Test Radarr configuration.
POST /api/v1/settings/radarr/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_sonarrAIdempotent
Create Sonarr instance.
POST /api/v1/settings/sonarr
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_sonarr_testAIdempotent
Test Sonarr configuration.
POST /api/v1/settings/sonarr/test
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_settings_tautulliAIdempotent
Update Tautulli settings.
POST /api/v1/settings/tautulli
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_userCIdempotent
Create new user.
POST /api/v1/user
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_user_by_user_id_settings_mainBIdempotent
Update general settings for a user.
POST /api/v1/user/{userId}/settings/main
Args: user_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), user_id (required). Returns: result
create_user_by_user_id_settings_notificationsAIdempotent
Update notification settings for a user.
POST /api/v1/user/{userId}/settings/notifications
Args: user_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), user_id (required). Returns: result
create_user_by_user_id_settings_passwordAIdempotent
Update password for a user.
POST /api/v1/user/{userId}/settings/password
Args: user_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), user_id (required). Returns: result
create_user_by_user_id_settings_permissionsBIdempotent
Update permission settings for a user.
POST /api/v1/user/{userId}/settings/permissions
Args: user_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), user_id (required). Returns: result
create_user_import_from_plexBIdempotent
Import all users from Plex.
POST /api/v1/user/import-from-plex
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
create_user_register_push_subscriptionAIdempotent
Register a web push /user/registerPushSubscription.
POST /api/v1/user/registerPushSubscription
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
delete_issue_by_issue_idBDestructiveIdempotent
Delete issue.
DELETE /api/v1/issue/{issueId}
Args: issue_id: Issue ID
Inputs: issue_id (required). Returns: result
delete_issue_comment_by_comment_idBDestructiveIdempotent
Delete issue comment.
DELETE /api/v1/issueComment/{commentId}
Args: comment_id: Issue Comment ID
Inputs: comment_id (required). Returns: result
delete_media_by_media_idBDestructiveIdempotent
Delete media item.
DELETE /api/v1/media/{mediaId}
Args: media_id: Media ID
Inputs: media_id (required). Returns: result
delete_request_by_request_idCDestructiveIdempotent
Delete request.
DELETE /api/v1/request/{requestId}
Args: request_id: Request ID
Inputs: request_id (required). Returns: result
delete_settings_discover_by_slider_idBDestructiveIdempotent
Delete slider by ID.
DELETE /api/v1/settings/discover/{sliderId}
Args: slider_id: Path parameter.
Inputs: slider_id (required). Returns: result
delete_settings_radarr_by_radarr_idBDestructiveIdempotent
Delete Radarr instance.
DELETE /api/v1/settings/radarr/{radarrId}
Args: radarr_id: Radarr instance ID
Inputs: radarr_id (required). Returns: result
delete_settings_sonarr_by_sonarr_idADestructiveIdempotent
Delete Sonarr instance.
DELETE /api/v1/settings/sonarr/{sonarrId}
Args: sonarr_id: Sonarr instance ID
Inputs: sonarr_id (required). Returns: result
delete_user_by_user_idADestructiveIdempotent
Delete user by ID.
DELETE /api/v1/user/{userId}
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
delete_user_by_user_id_push_subscription_by_endpointBDestructiveIdempotent
Delete user push subscription by key.
DELETE /api/v1/user/{userId}/pushSubscription/{endpoint}
Args: user_id: Path parameter. endpoint: Path parameter.
Inputs: user_id (required), endpoint (required). Returns: result
get_collection_by_collection_idBRead-onlyIdempotent
Get collection details.
GET /api/v1/collection/{collectionId}
Args: collection_id: Path parameter. language: Query parameter.
Inputs: collection_id (required), language. Returns: result
get_discover_keyword_by_keyword_id_moviesBRead-onlyIdempotent
Get movies from keyword.
GET /api/v1/discover/keyword/{keywordId}/movies
Args: keyword_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: keyword_id (required), page, language. Returns: result
get_discover_movies_genre_by_genre_idBRead-onlyIdempotent
Discover movies by genre.
GET /api/v1/discover/movies/genre/{genreId}
Args: genre_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: genre_id (required), page, language. Returns: result
get_discover_movies_language_by_languageCRead-onlyIdempotent
Discover movies by original language.
GET /api/v1/discover/movies/language/{language}
Args: language: Path parameter. page: Query parameter. language_query: Query parameter.
Inputs: language (required), page, language_query. Returns: result
get_discover_movies_studio_by_studio_idBRead-onlyIdempotent
Discover movies by studio.
GET /api/v1/discover/movies/studio/{studioId}
Args: studio_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: studio_id (required), page, language. Returns: result
get_discover_tv_genre_by_genre_idBRead-onlyIdempotent
Discover TV shows by genre.
GET /api/v1/discover/tv/genre/{genreId}
Args: genre_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: genre_id (required), page, language. Returns: result
get_discover_tv_language_by_languageCRead-onlyIdempotent
Discover TV shows by original language.
GET /api/v1/discover/tv/language/{language}
Args: language: Path parameter. page: Query parameter. language_query: Query parameter.
Inputs: language (required), page, language_query. Returns: result
get_discover_tv_network_by_network_idBRead-onlyIdempotent
Discover TV shows by network.
GET /api/v1/discover/tv/network/{networkId}
Args: network_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: network_id (required), page, language. Returns: result
get_issue_by_issue_idCRead-onlyIdempotent
Get issue.
GET /api/v1/issue/{issueId}
Args: issue_id: Path parameter.
Inputs: issue_id (required). Returns: result
get_issue_comment_by_comment_idBRead-onlyIdempotent
Get issue comment.
GET /api/v1/issueComment/{commentId}
Args: comment_id: Path parameter.
Inputs: comment_id (required). Returns: result
get_keyword_by_keyword_idCRead-onlyIdempotent
Get keyword.
GET /api/v1/keyword/{keywordId}
Args: keyword_id: Path parameter.
Inputs: keyword_id (required). Returns: result
get_media_by_media_id_watch_dataDRead-onlyIdempotent
Get watch data.
GET /api/v1/media/{mediaId}/watch_data
Args: media_id: Media ID
Inputs: media_id (required). Returns: result
get_movie_by_movie_idBRead-onlyIdempotent
Get movie details.
GET /api/v1/movie/{movieId}
Args: movie_id: Path parameter. language: Query parameter.
Inputs: movie_id (required), language. Returns: result
get_movie_by_movie_id_ratingsARead-onlyIdempotent
Get movie ratings.
GET /api/v1/movie/{movieId}/ratings
Args: movie_id: Path parameter.
Inputs: movie_id (required). Returns: result
get_movie_by_movie_id_ratingscombinedBRead-onlyIdempotent
Get RT and IMDB movie ratings combined.
GET /api/v1/movie/{movieId}/ratingscombined
Args: movie_id: Path parameter.
Inputs: movie_id (required). Returns: result
get_movie_by_movie_id_recommendationsBRead-onlyIdempotent
Get recommended movies.
GET /api/v1/movie/{movieId}/recommendations
Args: movie_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: movie_id (required), page, language. Returns: result
get_movie_by_movie_id_similarCRead-onlyIdempotent
Get similar movies.
GET /api/v1/movie/{movieId}/similar
Args: movie_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: movie_id (required), page, language. Returns: result
get_network_by_network_idBRead-onlyIdempotent
Get TV network details.
GET /api/v1/network/{networkId}
Args: network_id: Path parameter.
Inputs: network_id (required). Returns: result
get_person_by_person_idBRead-onlyIdempotent
Get person details.
GET /api/v1/person/{personId}
Args: person_id: Path parameter. language: Query parameter.
Inputs: person_id (required), language. Returns: result
get_person_by_person_id_combined_creditsBRead-onlyIdempotent
Get combined credits.
GET /api/v1/person/{personId}/combined_credits
Args: person_id: Path parameter. language: Query parameter.
Inputs: person_id (required), language. Returns: result
get_request_by_request_idBRead-onlyIdempotent
Get MediaRequest.
GET /api/v1/request/{requestId}
Args: request_id: Request ID
Inputs: request_id (required). Returns: result
get_result_pageARead-onlyIdempotent
Read more of a result that was too large to return in one piece.
Any tool whose answer is too large returns its first page with a
paging block. Pass that block's result_id here. Nothing is fetched
again: the stored result is paged, filtered and narrowed.
Args:
result_id: From the paging block of the earlier answer.
offset: First item to return, usually the previous next_offset.
limit: At most this many items. Fewer come back if they would not fit.
fields: Only these keys of each item. Dots reach nested keys, such as
"statistics.sizeOnDisk". The paging.fields list shows what exists.
match: Keep only items whose field contains this text, ignoring case,
for example {"title": "alien", "year": "1979"}.
path: Which list to page when the result holds several, as named in
paging.lists. Defaults to the largest.
Inputs: result_id (required), path, limit, match, +2 more. Returns: result
get_service_radarr_by_radarr_idBRead-onlyIdempotent
Get Radarr server quality profiles and root folders.
GET /api/v1/service/radarr/{radarrId}
Args: radarr_id: Path parameter.
Inputs: radarr_id (required). Returns: result
get_service_sonarr_by_sonarr_idARead-onlyIdempotent
Get Sonarr server quality profiles and root folders.
GET /api/v1/service/sonarr/{sonarrId}
Args: sonarr_id: Path parameter.
Inputs: sonarr_id (required). Returns: result
get_service_sonarr_lookup_by_tmdb_idCRead-onlyIdempotent
Get series from Sonarr.
GET /api/v1/service/sonarr/lookup/{tmdbId}
Args: tmdb_id: Path parameter.
Inputs: tmdb_id (required). Returns: result
get_settings_radarr_by_radarr_id_profilesBRead-onlyIdempotent
Get available Radarr profiles.
GET /api/v1/settings/radarr/{radarrId}/profiles
Args: radarr_id: Radarr instance ID
Inputs: radarr_id (required). Returns: result
get_studio_by_studio_idCRead-onlyIdempotent
Get movie studio details.
GET /api/v1/studio/{studioId}
Args: studio_id: Path parameter.
Inputs: studio_id (required). Returns: result
get_tv_by_tv_idBRead-onlyIdempotent
Get TV details.
GET /api/v1/tv/{tvId}
Args: tv_id: Path parameter. language: Query parameter.
Inputs: tv_id (required), language. Returns: result
get_tv_by_tv_id_ratingsARead-onlyIdempotent
Get TV ratings.
GET /api/v1/tv/{tvId}/ratings
Args: tv_id: Path parameter.
Inputs: tv_id (required). Returns: result
get_tv_by_tv_id_recommendationsCRead-onlyIdempotent
Get recommended TV series.
GET /api/v1/tv/{tvId}/recommendations
Args: tv_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: tv_id (required), page, language. Returns: result
get_tv_by_tv_id_season_by_season_idBRead-onlyIdempotent
Get season details and episode list.
GET /api/v1/tv/{tvId}/season/{seasonId}
Args: tv_id: Path parameter. season_id: Path parameter. language: Query parameter.
Inputs: tv_id (required), season_id (required), language. Returns: result
get_tv_by_tv_id_similarCRead-onlyIdempotent
Get similar TV series.
GET /api/v1/tv/{tvId}/similar
Args: tv_id: Path parameter. page: Query parameter. language: Query parameter.
Inputs: tv_id (required), page, language. Returns: result
get_user_by_user_idBRead-onlyIdempotent
Get user by ID.
GET /api/v1/user/{userId}
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
get_user_by_user_id_push_subscription_by_endpointBRead-onlyIdempotent
Get web push notification settings for a user.
GET /api/v1/user/{userId}/pushSubscription/{endpoint}
Args: user_id: Path parameter. endpoint: Path parameter.
Inputs: user_id (required), endpoint (required). Returns: result
get_user_by_user_id_push_subscriptionsARead-onlyIdempotent
Get all web push notification settings for a user.
GET /api/v1/user/{userId}/pushSubscriptions
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
get_user_by_user_id_quotaBRead-onlyIdempotent
Get quotas for a specific user.
GET /api/v1/user/{userId}/quota
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
get_user_by_user_id_requestsBRead-onlyIdempotent
Get requests for a specific user.
GET /api/v1/user/{userId}/requests
Args: user_id: Path parameter. take: Query parameter. skip: Query parameter.
Inputs: user_id (required), skip, take. Returns: result
get_user_by_user_id_settings_mainBRead-onlyIdempotent
Get general settings for a user.
GET /api/v1/user/{userId}/settings/main
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
get_user_by_user_id_settings_notificationsARead-onlyIdempotent
Get notification settings for a user.
GET /api/v1/user/{userId}/settings/notifications
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
get_user_by_user_id_settings_passwordBRead-onlyIdempotent
Get password page informatiom.
GET /api/v1/user/{userId}/settings/password
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
get_user_by_user_id_settings_permissionsBRead-onlyIdempotent
Get permission settings for a user.
GET /api/v1/user/{userId}/settings/permissions
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
get_user_by_user_id_watch_dataCRead-onlyIdempotent
Get watch data.
GET /api/v1/user/{userId}/watch_data
Args: user_id: Path parameter.
Inputs: user_id (required). Returns: result
get_user_by_user_id_watchlistARead-onlyIdempotent
Get the Plex watchlist for a specific user.
GET /api/v1/user/{userId}/watchlist
Args: user_id: Path parameter. page: Query parameter.
Inputs: user_id (required), page. Returns: result
list_auth_meBRead-onlyIdempotent
Get logged-in user.
GET /api/v1/auth/me
Inputs: no named parameters. Returns: result
list_backdropsARead-onlyIdempotent
Get backdrops of trending items.
GET /api/v1/backdrops
Inputs: no named parameters. Returns: result
list_discover_genreslider_movieBRead-onlyIdempotent
Get genre slider data for movies.
GET /api/v1/discover/genreslider/movie
Args: language: Query parameter.
Inputs: language. Returns: result
list_discover_genreslider_tvARead-onlyIdempotent
Get genre slider data for TV series.
GET /api/v1/discover/genreslider/tv
Args: language: Query parameter.
Inputs: language. Returns: result
list_discover_moviesCRead-onlyIdempotent
Discover movies.
GET /api/v1/discover/movies
Args: page: Query parameter. language: Query parameter. genre: Query parameter. studio: Query parameter. keywords: Query parameter. sort_by: Query parameter. primary_release_date_gte: Query parameter. primary_release_date_lte: Query parameter. with_runtime_gte: Query parameter. with_runtime_lte: Query parameter. vote_average_gte: Query parameter. vote_average_lte: Query parameter. vote_count_gte: Query parameter. vote_count_lte: Query parameter. watch_region: Query parameter. watch_providers: Query parameter.
Inputs: page, genre, studio, sort_by, +12 more. Returns: result
list_discover_movies_upcomingCRead-onlyIdempotent
Upcoming movies.
GET /api/v1/discover/movies/upcoming
Args: page: Query parameter. language: Query parameter.
Inputs: page, language. Returns: result
list_discover_trendingARead-onlyIdempotent
Trending movies and TV.
GET /api/v1/discover/trending
Args: page: Query parameter. language: Query parameter.
Inputs: page, language. Returns: result
list_discover_tvCRead-onlyIdempotent
Discover TV shows.
GET /api/v1/discover/tv
Args: page: Query parameter. language: Query parameter. genre: Query parameter. network: Query parameter. keywords: Query parameter. sort_by: Query parameter. first_air_date_gte: Query parameter. first_air_date_lte: Query parameter. with_runtime_gte: Query parameter. with_runtime_lte: Query parameter. vote_average_gte: Query parameter. vote_average_lte: Query parameter. vote_count_gte: Query parameter. vote_count_lte: Query parameter. watch_region: Query parameter. watch_providers: Query parameter.
Inputs: page, genre, network, sort_by, +12 more. Returns: result
list_discover_tv_upcomingCRead-onlyIdempotent
Discover Upcoming TV shows.
GET /api/v1/discover/tv/upcoming
Args: page: Query parameter. language: Query parameter.
Inputs: page, language. Returns: result
list_discover_watchlistBRead-onlyIdempotent
Get the Plex watchlist.
GET /api/v1/discover/watchlist
Args: page: Query parameter.
Inputs: page. Returns: result
list_genres_movieARead-onlyIdempotent
Get list of official TMDB movie genres.
GET /api/v1/genres/movie
Args: language: Query parameter.
Inputs: language. Returns: result
list_genres_tvCRead-onlyIdempotent
Get list of official TMDB movie genres.
GET /api/v1/genres/tv
Args: language: Query parameter.
Inputs: language. Returns: result
list_issueBRead-onlyIdempotent
Get all issues.
GET /api/v1/issue
Args: take: Query parameter. skip: Query parameter. sort: Query parameter. filter: Query parameter. requested_by: Query parameter.
Inputs: skip, sort, take, filter, +1 more. Returns: result
list_issue_countBRead-onlyIdempotent
Gets issue counts.
GET /api/v1/issue/count
Inputs: no named parameters. Returns: result
list_languagesARead-onlyIdempotent
Languages supported by TMDB.
GET /api/v1/languages
Inputs: no named parameters. Returns: result
list_mediaCRead-onlyIdempotent
Get media.
GET /api/v1/media
Args: take: Query parameter. skip: Query parameter. filter: Query parameter. sort: Query parameter.
Inputs: skip, sort, take, filter. Returns: result
list_regionsBRead-onlyIdempotent
Regions supported by TMDB.
GET /api/v1/regions
Inputs: no named parameters. Returns: result
list_requestCRead-onlyIdempotent
Get all requests.
GET /api/v1/request
Args: take: Query parameter. skip: Query parameter. filter: Query parameter. sort: Query parameter. requested_by: Query parameter.
Inputs: skip, sort, take, filter, +1 more. Returns: result
list_request_countBRead-onlyIdempotent
Gets request counts.
GET /api/v1/request/count
Inputs: no named parameters. Returns: result
list_searchCRead-onlyIdempotent
Search for movies, TV shows, or people.
GET /api/v1/search
Args: query: Query parameter. page: Query parameter. language: Query parameter.
Inputs: page, query, language. Returns: result
list_search_companyCRead-onlyIdempotent
Search for companies.
GET /api/v1/search/company
Args: query: Query parameter. page: Query parameter.
Inputs: page, query. Returns: result
list_search_keywordCRead-onlyIdempotent
Search for keywords.
GET /api/v1/search/keyword
Args: query: Query parameter. page: Query parameter.
Inputs: page, query. Returns: result
list_service_radarrARead-onlyIdempotent
Get non-sensitive Radarr server list.
GET /api/v1/service/radarr
Inputs: no named parameters. Returns: result
list_service_sonarrARead-onlyIdempotent
Get non-sensitive Sonarr server list.
GET /api/v1/service/sonarr
Inputs: no named parameters. Returns: result
list_settings_aboutARead-onlyIdempotent
Get server stats.
GET /api/v1/settings/about
Inputs: no named parameters. Returns: result
list_settings_cacheARead-onlyIdempotent
Get a list of active caches.
GET /api/v1/settings/cache
Inputs: no named parameters. Returns: result
list_settings_discoverARead-onlyIdempotent
Get all discover sliders.
GET /api/v1/settings/discover
Inputs: no named parameters. Returns: result
list_settings_discover_resetCRead-onlyIdempotent
Reset all discover sliders.
GET /api/v1/settings/discover/reset
Inputs: no named parameters. Returns: result
list_settings_jobsARead-onlyIdempotent
Get scheduled jobs.
GET /api/v1/settings/jobs
Inputs: no named parameters. Returns: result
list_settings_logsCRead-onlyIdempotent
Returns logs.
GET /api/v1/settings/logs
Args: take: Query parameter. skip: Query parameter. filter: Query parameter. search: Query parameter.
Inputs: skip, take, filter, search. Returns: result
list_settings_mainARead-onlyIdempotent
Get main settings.
GET /api/v1/settings/main
Inputs: no named parameters. Returns: result
list_settings_notifications_discordBRead-onlyIdempotent
Get Discord notification settings.
GET /api/v1/settings/notifications/discord
Inputs: no named parameters. Returns: result
list_settings_notifications_emailARead-onlyIdempotent
Get email notification settings.
GET /api/v1/settings/notifications/email
Inputs: no named parameters. Returns: result
list_settings_notifications_gotifyARead-onlyIdempotent
Get Gotify notification settings.
GET /api/v1/settings/notifications/gotify
Inputs: no named parameters. Returns: result
list_settings_notifications_lunaseaARead-onlyIdempotent
Get LunaSea notification settings.
GET /api/v1/settings/notifications/lunasea
Inputs: no named parameters. Returns: result
list_settings_notifications_pushbulletARead-onlyIdempotent
Get Pushbullet notification settings.
GET /api/v1/settings/notifications/pushbullet
Inputs: no named parameters. Returns: result
list_settings_notifications_pushoverARead-onlyIdempotent
Get Pushover notification settings.
GET /api/v1/settings/notifications/pushover
Inputs: no named parameters. Returns: result
list_settings_notifications_pushover_soundsBRead-onlyIdempotent
Get Pushover sounds.
GET /api/v1/settings/notifications/pushover/sounds
Args: token: Query parameter.
Inputs: token. Returns: result
list_settings_notifications_slackARead-onlyIdempotent
Get Slack notification settings.
GET /api/v1/settings/notifications/slack
Inputs: no named parameters. Returns: result
list_settings_notifications_telegramARead-onlyIdempotent
Get Telegram notification settings.
GET /api/v1/settings/notifications/telegram
Inputs: no named parameters. Returns: result
list_settings_notifications_webhookARead-onlyIdempotent
Get webhook notification settings.
GET /api/v1/settings/notifications/webhook
Inputs: no named parameters. Returns: result
list_settings_notifications_webpushARead-onlyIdempotent
Get Web Push notification settings.
GET /api/v1/settings/notifications/webpush
Inputs: no named parameters. Returns: result
list_settings_plexBRead-onlyIdempotent
Get Plex settings.
GET /api/v1/settings/plex
Inputs: no named parameters. Returns: result
list_settings_plex_devices_serversARead-onlyIdempotent
Gets the user's available Plex servers.
GET /api/v1/settings/plex/devices/servers
Inputs: no named parameters. Returns: result
list_settings_plex_libraryCRead-onlyIdempotent
Get Plex libraries.
GET /api/v1/settings/plex/library
Args: sync: Syncs the current libraries with the current Plex server enable: Comma separated list of libraries to enable. Any libraries not passed will be disabled!
Inputs: sync, enable. Returns: result
list_settings_plex_syncARead-onlyIdempotent
Get status of full Plex library scan.
GET /api/v1/settings/plex/sync
Inputs: no named parameters. Returns: result
list_settings_plex_usersARead-onlyIdempotent
Get Plex users.
GET /api/v1/settings/plex/users
Inputs: no named parameters. Returns: result
list_settings_publicBRead-onlyIdempotent
Get public settings.
GET /api/v1/settings/public
Inputs: no named parameters. Returns: result
list_settings_radarrCRead-onlyIdempotent
Get Radarr settings.
GET /api/v1/settings/radarr
Inputs: no named parameters. Returns: result
list_settings_sonarrARead-onlyIdempotent
Get Sonarr settings.
GET /api/v1/settings/sonarr
Inputs: no named parameters. Returns: result
list_settings_tautulliARead-onlyIdempotent
Get Tautulli settings.
GET /api/v1/settings/tautulli
Inputs: no named parameters. Returns: result
list_statusARead-onlyIdempotent
Get Overseerr status.
GET /api/v1/status
Inputs: no named parameters. Returns: result
list_status_appdataARead-onlyIdempotent
Get application data volume status.
GET /api/v1/status/appdata
Inputs: no named parameters. Returns: result
list_userCRead-onlyIdempotent
Get all users.
GET /api/v1/user
Args: take: Query parameter. skip: Query parameter. sort: Query parameter.
Inputs: skip, sort, take. Returns: result
list_watchproviders_moviesCRead-onlyIdempotent
Get watch provider movies.
GET /api/v1/watchproviders/movies
Args: watch_region: Query parameter.
Inputs: watch_region. Returns: result
list_watchproviders_regionsBRead-onlyIdempotent
Get watch provider regions.
GET /api/v1/watchproviders/regions
Inputs: no named parameters. Returns: result
list_watchproviders_tvBRead-onlyIdempotent
Get watch provider series.
GET /api/v1/watchproviders/tv
Args: watch_region: Query parameter.
Inputs: watch_region. Returns: result
update_issue_comment_by_comment_idAIdempotent
Update issue comment.
PUT /api/v1/issueComment/{commentId}
Args: comment_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), comment_id (required). Returns: result
update_request_by_request_idAIdempotent
Update MediaRequest.
PUT /api/v1/request/{requestId}
Args: request_id: Request ID body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), request_id (required). Returns: result
update_settings_discover_by_slider_idAIdempotent
Update a single slider.
PUT /api/v1/settings/discover/{sliderId}
Args: slider_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), slider_id (required). Returns: result
update_settings_radarr_by_radarr_idAIdempotent
Update Radarr instance.
PUT /api/v1/settings/radarr/{radarrId}
Args: radarr_id: Radarr instance ID body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), radarr_id (required). Returns: result
update_settings_sonarr_by_sonarr_idAIdempotent
Update Sonarr instance.
PUT /api/v1/settings/sonarr/{sonarrId}
Args: sonarr_id: Sonarr instance ID body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), sonarr_id (required). Returns: result
update_userAIdempotent
Update batch of users.
PUT /api/v1/user
Args: body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required). Returns: result
update_user_by_user_idAIdempotent
Update a user by user ID.
PUT /api/v1/user/{userId}
Args: user_id: Path parameter. body: Request payload. Read the matching GET or the /schema endpoint first to see the fields this resource expects.
Inputs: body (required), user_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 171 tools
With 171 tools covering the entire Overseerr/Jellyseerr API, there are many near-duplicates and overlapping surfaces. For instance, list_settings_radarr vs list_service_radarr, get_movie_by_movie_id_ratings vs get_movie_by_movie_id_ratingscombined, and several get_/list_ pairs with subtly different endpoints create significant ambiguity. The sheer volume and similar naming patterns make it easy for an agent to pick the wrong tool.
The names largely follow a verb_noun_by_id pattern, but the verb choice is inconsistent and often misleading (e.g., create_ for POST status updates, list_ for GET operations that aren't lists). The API-derived naming with by_id suffixes is systematic but not semantically clean, and some names like list_search are awkward.
171 tools is an extreme mismatch for a usable MCP server. Even a comprehensive API surface should be curated or bundled; exposing every endpoint individually overwhelms an agent's context and decision-making. This is a clear case of excessive tool count.
The surface appears to cover the full Overseerr API comprehensively, including CRUD for users, requests, issues, settings, discovery, and services. Only minor gaps (e.g., some niche notification or status endpoints) might exist, but overall it's very complete.
Maintenance
Related MCP Connectors
One workspace of tools for Claude and ChatGPT: connect 600+ apps, generate media, build tools.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.6111 npm26MIT
- AlicenseBqualityCmaintenanceMCP server exposing Seerr's full v1 REST API as tools, enabling LLMs to search and discover media, manage requests and approvals, users, issues, watchlists, and integration settings for Plex/Jellyfin/Emby and Sonarr/Radarr, including reads and writes with destructive operations flagged.151MIT
- AlicenseCqualityBmaintenanceEnables full control of Sonarr from Claude.ai and Claude Code by exposing all 234 v3 API operations as tools for managing media libraries.23523 npmMIT
- AlicenseCqualityBmaintenanceExposes all 209 Audiobookshelf API routes as tools, letting Claude.ai and Claude Code manage libraries, books, podcasts, playback, users, settings, and more.212131 npmMIT