Skip to main content
Glama
suckerfish

Overseerr MCP Server

by suckerfish
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
OVERSEERR_URLYesThe URL of your Overseerr instance (e.g., http://your-overseerr-ip:5055)
OVERSEERR_API_KEYYesYour admin API key from Overseerr Settings → General → API Key

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tasks
{
  "list": {},
  "cancel": {},
  "requests": {
    "tools": {
      "call": {}
    },
    "prompts": {
      "get": {}
    },
    "resources": {
      "read": {}
    }
  }
}
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_mediaA

Search for movies and TV shows in Overseerr.

This searches TMDB (external database), not your Plex library. To search content you already own, use search_library instead.

Use this to find media by title before making a request. Returns TMDB IDs needed for requesting media.

Args: query: Search term (movie or TV show title) media_type: Optional filter - "movie" or "tv"

Returns: List of matching movies/TV shows with TMDB IDs, titles, years, ratings, and availability status

search_libraryA

Search your Plex library for movies and TV shows you already have.

Use this when a user asks what's in their library or wants to find content they already own. This searches by title substring within Plex, so "dracula" will match "Bram Stoker's Dracula".

To search for new content to request, use search_media instead.

Args: query: Title to search for (substring match) media_type: Optional filter - "movie" or "tv"

Returns: List of matching items from your Plex library with title, year, rating, and type

get_requestsA

Get media requests with user information.

Lists all requests showing who requested what and when. Perfect for queries like "list all requests from the last week and who requested them".

Args: status: Filter by request approval status - "pending" or "approved" media_status: Filter by availability - "available", "processing", "unavailable", or "failed" days: Optional - only show requests from the last N days limit: Maximum number of requests to return (default 20) show_all: Set to true to return all matching requests (ignores limit)

Returns: List of requests with titles, requesters, request status, and media availability

get_usersA

Get all Overseerr users.

Lists all users with their IDs and request counts. Use the user ID to get a specific user's requests.

Returns: List of users with IDs, names, and request counts

get_user_requestsA

Get all requests made by a specific user.

Shows all media requests from a particular user. Get the user_id from the get_users tool.

Args: user_id: The Overseerr user ID media_status: Filter by availability - "processing", "available", or "partially_available" limit: Maximum number of requests to return (default 20) show_all: Set to true to return all matching requests (ignores limit)

Returns: User info and their request history filtered by media status

request_mediaA

Request a movie or TV show to be added to Plex.

Use search_media first to find the TMDB ID for the content you want.

For TV shows with multiple seasons, you must specify which seasons to request. Single-season shows are auto-selected.

Args: tmdb_id: TMDB ID of the movie or TV show (from search results) media_type: "movie" or "tv" seasons: For TV shows - comma-separated season numbers (e.g., "1,2,3") or "all"

Returns: Request confirmation with title, status, and request ID

health_checkA

Check Overseerr server status and connectivity.

Verifies the MCP server can connect to Overseerr.

Returns: Server status and version information

get_media_statusA

Check the availability status of a movie or TV show.

Use search_media first to find the TMDB ID, then check its detailed status. Returns whether media is available, being processed, or needs to be requested.

Args: tmdb_id: TMDB ID of the movie or TV show (from search results) media_type: "movie" or "tv"

Returns: Status information including: - status: Numeric status code (1=Unknown, 2=Requested, 3=Processing, 4=Partially Available, 5=Available) - status_text: Human-readable status like "Available" or "Processing" - has_request: Whether any request exists for this media - request_status: Status of existing request ("Pending", "Approved", "Declined") - seasons_count: (TV only) Total number of seasons

get_issuesA

Get Overseerr issues (reports of problems with media).

Args: filter: "all", "open", or "resolved" (defaults to open) limit: Maximum number of issues to return (default 20) sort: "added" or "modified" (default added)

Returns: List of issues with type, status, reporter, and associated media

get_issueA

Get a single issue with its comments.

Args: issue_id: The issue ID

Returns: Issue details including all comments

update_issue_statusA

Update an issue's status (open or resolve it).

Args: issue_id: The issue ID status: "open" or "resolved"

Returns: Updated issue details

add_issue_commentA

Add a comment to an issue.

Args: issue_id: The issue ID message: The comment text

Returns: The created comment

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/suckerfish/overseerr-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server