Skip to main content
Glama
seerr-mcp

seerr-mcp

by rollecode

Seerr MCP server

Version Python Overseerr Coverage

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.

WARNING

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

davidgibbons/mcp-arr (jellyseerr)

9

5 %

cyanheads/seerr-mcp-server

search, availability, request

partial

aserper/jellyseerr-mcp, ptbsare/overseerr-mcp-server

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.py

A 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

list_*

Read a collection

list_request, list_issue

get_*_by_id

Read one record

get_movie_by_movie_id

create_*

POST

create_request, create_auth_local

update_*

PUT

update_settings_main

delete_*

DELETE

delete_request_by_request_id

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 Key

Claude Code

claude mcp add seerr -- /path/to/seerr-mcp/.venv/bin/seerr-mcp

Writing 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

seerr-mcp

8550

The server. No login of its own, never exposed

nginx

8551

Front door, behind a Cloudflare Tunnel

auth-server.js

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/env

Copy systemd/*.service into /etc/systemd/system/, replacing YOUR_USER and the ISSUER hostname, then:

sudo systemctl enable --now seerr-mcp seerr-mcp-auth

Point 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 tools
create_auth_localA
Idempotent

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_logoutA
Idempotent

Sign out and clear session cookie.

POST /api/v1/auth/logout

Inputs: no named parameters. Returns: result

create_auth_plexA
Idempotent

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_passwordB
Idempotent

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_guidA
Idempotent

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_issueC
Idempotent

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_statusA
Idempotent

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_commentB
Idempotent

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_statusA
Idempotent

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_requestC
Idempotent

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_statusB
Idempotent

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_retryB
Idempotent

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_flushC
Idempotent

Flush a specific cache.

POST /api/v1/settings/cache/{cacheId}/flush

Args: cache_id: Path parameter.

Inputs: cache_id (required). Returns: result

create_settings_discoverA
Idempotent

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_addA
Idempotent

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_initializeB
Idempotent

Initialize application.

POST /api/v1/settings/initialize

Inputs: no named parameters. Returns: result

create_settings_jobs_by_job_id_cancelB
Idempotent

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_runB
Idempotent

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_scheduleA
Idempotent

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_mainA
Idempotent

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_regenerateA
Idempotent

Get main settings with newly-generated API key.

POST /api/v1/settings/main/regenerate

Inputs: no named parameters. Returns: result

create_settings_notifications_discordA
Idempotent

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_testC
Idempotent

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_emailA
Idempotent

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_testB
Idempotent

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_gotifyB
Idempotent

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_testC
Idempotent

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_lunaseaC
Idempotent

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_testC
Idempotent

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_pushbulletA
Idempotent

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_testB
Idempotent

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_pushoverA
Idempotent

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_testB
Idempotent

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_slackA
Idempotent

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_testC
Idempotent

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_telegramA
Idempotent

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_testC
Idempotent

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_webhookB
Idempotent

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_testA
Idempotent

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_webpushC
Idempotent

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_testB
Idempotent

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_plexA
Idempotent

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_syncA
Idempotent

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_radarrC
Idempotent

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_testA
Idempotent

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_sonarrA
Idempotent

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_testA
Idempotent

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_tautulliA
Idempotent

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_userC
Idempotent

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_mainB
Idempotent

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_notificationsA
Idempotent

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_passwordA
Idempotent

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_permissionsB
Idempotent

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_plexB
Idempotent

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_subscriptionA
Idempotent

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_idB
DestructiveIdempotent

Delete issue.

DELETE /api/v1/issue/{issueId}

Args: issue_id: Issue ID

Inputs: issue_id (required). Returns: result

delete_issue_comment_by_comment_idB
DestructiveIdempotent

Delete issue comment.

DELETE /api/v1/issueComment/{commentId}

Args: comment_id: Issue Comment ID

Inputs: comment_id (required). Returns: result

delete_media_by_media_idB
DestructiveIdempotent

Delete media item.

DELETE /api/v1/media/{mediaId}

Args: media_id: Media ID

Inputs: media_id (required). Returns: result

delete_request_by_request_idC
DestructiveIdempotent

Delete request.

DELETE /api/v1/request/{requestId}

Args: request_id: Request ID

Inputs: request_id (required). Returns: result

delete_settings_discover_by_slider_idB
DestructiveIdempotent

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_idB
DestructiveIdempotent

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_idA
DestructiveIdempotent

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_idA
DestructiveIdempotent

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_endpointB
DestructiveIdempotent

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_idB
Read-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_moviesB
Read-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_idB
Read-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_languageC
Read-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_idB
Read-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_idB
Read-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_languageC
Read-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_idB
Read-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_idC
Read-onlyIdempotent

Get issue.

GET /api/v1/issue/{issueId}

Args: issue_id: Path parameter.

Inputs: issue_id (required). Returns: result

get_issue_comment_by_comment_idB
Read-onlyIdempotent

Get issue comment.

GET /api/v1/issueComment/{commentId}

Args: comment_id: Path parameter.

Inputs: comment_id (required). Returns: result

get_keyword_by_keyword_idC
Read-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_dataD
Read-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_idB
Read-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_ratingsA
Read-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_ratingscombinedB
Read-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_recommendationsB
Read-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_similarC
Read-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_idB
Read-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_idB
Read-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_creditsB
Read-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_idB
Read-onlyIdempotent

Get MediaRequest.

GET /api/v1/request/{requestId}

Args: request_id: Request ID

Inputs: request_id (required). Returns: result

get_result_pageA
Read-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_idB
Read-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_idA
Read-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_idC
Read-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_profilesB
Read-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_idC
Read-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_idB
Read-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_ratingsA
Read-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_recommendationsC
Read-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_idB
Read-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_similarC
Read-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_idB
Read-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_endpointB
Read-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_subscriptionsA
Read-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_quotaB
Read-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_requestsB
Read-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_mainB
Read-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_notificationsA
Read-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_passwordB
Read-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_permissionsB
Read-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_dataC
Read-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_watchlistA
Read-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_meB
Read-onlyIdempotent

Get logged-in user.

GET /api/v1/auth/me

Inputs: no named parameters. Returns: result

list_backdropsA
Read-onlyIdempotent

Get backdrops of trending items.

GET /api/v1/backdrops

Inputs: no named parameters. Returns: result

list_discover_genreslider_movieB
Read-onlyIdempotent

Get genre slider data for movies.

GET /api/v1/discover/genreslider/movie

Args: language: Query parameter.

Inputs: language. Returns: result

list_discover_genreslider_tvA
Read-onlyIdempotent

Get genre slider data for TV series.

GET /api/v1/discover/genreslider/tv

Args: language: Query parameter.

Inputs: language. Returns: result

list_discover_moviesC
Read-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_upcomingC
Read-onlyIdempotent

Upcoming movies.

GET /api/v1/discover/movies/upcoming

Args: page: Query parameter. language: Query parameter.

Inputs: page, language. Returns: result

list_discover_tvC
Read-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_upcomingC
Read-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_watchlistB
Read-onlyIdempotent

Get the Plex watchlist.

GET /api/v1/discover/watchlist

Args: page: Query parameter.

Inputs: page. Returns: result

list_genres_movieA
Read-onlyIdempotent

Get list of official TMDB movie genres.

GET /api/v1/genres/movie

Args: language: Query parameter.

Inputs: language. Returns: result

list_genres_tvC
Read-onlyIdempotent

Get list of official TMDB movie genres.

GET /api/v1/genres/tv

Args: language: Query parameter.

Inputs: language. Returns: result

list_issueB
Read-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_countB
Read-onlyIdempotent

Gets issue counts.

GET /api/v1/issue/count

Inputs: no named parameters. Returns: result

list_languagesA
Read-onlyIdempotent

Languages supported by TMDB.

GET /api/v1/languages

Inputs: no named parameters. Returns: result

list_mediaC
Read-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_regionsB
Read-onlyIdempotent

Regions supported by TMDB.

GET /api/v1/regions

Inputs: no named parameters. Returns: result

list_requestC
Read-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_countB
Read-onlyIdempotent

Gets request counts.

GET /api/v1/request/count

Inputs: no named parameters. Returns: result

list_search_companyC
Read-onlyIdempotent

Search for companies.

GET /api/v1/search/company

Args: query: Query parameter. page: Query parameter.

Inputs: page, query. Returns: result

list_search_keywordC
Read-onlyIdempotent

Search for keywords.

GET /api/v1/search/keyword

Args: query: Query parameter. page: Query parameter.

Inputs: page, query. Returns: result

list_service_radarrA
Read-onlyIdempotent

Get non-sensitive Radarr server list.

GET /api/v1/service/radarr

Inputs: no named parameters. Returns: result

list_service_sonarrA
Read-onlyIdempotent

Get non-sensitive Sonarr server list.

GET /api/v1/service/sonarr

Inputs: no named parameters. Returns: result

list_settings_aboutA
Read-onlyIdempotent

Get server stats.

GET /api/v1/settings/about

Inputs: no named parameters. Returns: result

list_settings_cacheA
Read-onlyIdempotent

Get a list of active caches.

GET /api/v1/settings/cache

Inputs: no named parameters. Returns: result

list_settings_discoverA
Read-onlyIdempotent

Get all discover sliders.

GET /api/v1/settings/discover

Inputs: no named parameters. Returns: result

list_settings_discover_resetC
Read-onlyIdempotent

Reset all discover sliders.

GET /api/v1/settings/discover/reset

Inputs: no named parameters. Returns: result

list_settings_jobsA
Read-onlyIdempotent

Get scheduled jobs.

GET /api/v1/settings/jobs

Inputs: no named parameters. Returns: result

list_settings_logsC
Read-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_mainA
Read-onlyIdempotent

Get main settings.

GET /api/v1/settings/main

Inputs: no named parameters. Returns: result

list_settings_notifications_discordB
Read-onlyIdempotent

Get Discord notification settings.

GET /api/v1/settings/notifications/discord

Inputs: no named parameters. Returns: result

list_settings_notifications_emailA
Read-onlyIdempotent

Get email notification settings.

GET /api/v1/settings/notifications/email

Inputs: no named parameters. Returns: result

list_settings_notifications_gotifyA
Read-onlyIdempotent

Get Gotify notification settings.

GET /api/v1/settings/notifications/gotify

Inputs: no named parameters. Returns: result

list_settings_notifications_lunaseaA
Read-onlyIdempotent

Get LunaSea notification settings.

GET /api/v1/settings/notifications/lunasea

Inputs: no named parameters. Returns: result

list_settings_notifications_pushbulletA
Read-onlyIdempotent

Get Pushbullet notification settings.

GET /api/v1/settings/notifications/pushbullet

Inputs: no named parameters. Returns: result

list_settings_notifications_pushoverA
Read-onlyIdempotent

Get Pushover notification settings.

GET /api/v1/settings/notifications/pushover

Inputs: no named parameters. Returns: result

list_settings_notifications_pushover_soundsB
Read-onlyIdempotent

Get Pushover sounds.

GET /api/v1/settings/notifications/pushover/sounds

Args: token: Query parameter.

Inputs: token. Returns: result

list_settings_notifications_slackA
Read-onlyIdempotent

Get Slack notification settings.

GET /api/v1/settings/notifications/slack

Inputs: no named parameters. Returns: result

list_settings_notifications_telegramA
Read-onlyIdempotent

Get Telegram notification settings.

GET /api/v1/settings/notifications/telegram

Inputs: no named parameters. Returns: result

list_settings_notifications_webhookA
Read-onlyIdempotent

Get webhook notification settings.

GET /api/v1/settings/notifications/webhook

Inputs: no named parameters. Returns: result

list_settings_notifications_webpushA
Read-onlyIdempotent

Get Web Push notification settings.

GET /api/v1/settings/notifications/webpush

Inputs: no named parameters. Returns: result

list_settings_plexB
Read-onlyIdempotent

Get Plex settings.

GET /api/v1/settings/plex

Inputs: no named parameters. Returns: result

list_settings_plex_devices_serversA
Read-onlyIdempotent

Gets the user's available Plex servers.

GET /api/v1/settings/plex/devices/servers

Inputs: no named parameters. Returns: result

list_settings_plex_libraryC
Read-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_syncA
Read-onlyIdempotent

Get status of full Plex library scan.

GET /api/v1/settings/plex/sync

Inputs: no named parameters. Returns: result

list_settings_plex_usersA
Read-onlyIdempotent

Get Plex users.

GET /api/v1/settings/plex/users

Inputs: no named parameters. Returns: result

list_settings_publicB
Read-onlyIdempotent

Get public settings.

GET /api/v1/settings/public

Inputs: no named parameters. Returns: result

list_settings_radarrC
Read-onlyIdempotent

Get Radarr settings.

GET /api/v1/settings/radarr

Inputs: no named parameters. Returns: result

list_settings_sonarrA
Read-onlyIdempotent

Get Sonarr settings.

GET /api/v1/settings/sonarr

Inputs: no named parameters. Returns: result

list_settings_tautulliA
Read-onlyIdempotent

Get Tautulli settings.

GET /api/v1/settings/tautulli

Inputs: no named parameters. Returns: result

list_statusA
Read-onlyIdempotent

Get Overseerr status.

GET /api/v1/status

Inputs: no named parameters. Returns: result

list_status_appdataA
Read-onlyIdempotent

Get application data volume status.

GET /api/v1/status/appdata

Inputs: no named parameters. Returns: result

list_userC
Read-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_moviesC
Read-onlyIdempotent

Get watch provider movies.

GET /api/v1/watchproviders/movies

Args: watch_region: Query parameter.

Inputs: watch_region. Returns: result

list_watchproviders_regionsB
Read-onlyIdempotent

Get watch provider regions.

GET /api/v1/watchproviders/regions

Inputs: no named parameters. Returns: result

list_watchproviders_tvB
Read-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_idA
Idempotent

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_idA
Idempotent

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_idA
Idempotent

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_idA
Idempotent

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_idA
Idempotent

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_userA
Idempotent

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_idA
Idempotent

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

    C2.6/5.0

    Scored across 171 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      MCP 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.
      15
      1
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables full control of Sonarr from Claude.ai and Claude Code by exposing all 234 v3 API operations as tools for managing media libraries.
      235
      23 npm
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Exposes all 209 Audiobookshelf API routes as tools, letting Claude.ai and Claude Code manage libraries, books, podcasts, playback, users, settings, and more.
      212
      131 npm
      MIT