Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
From overseerr-mcp
This skill should be used when the user says "request movie", "request TV show", "get something on Plex", "search Overseerr", "request media", "submit media request", "check request status", "has my request been approved", "is X available yet", "list failed requests", "approve this request", "decline this request", "what's trending on Plex", "what movies are coming out", "recommend something similar to X", "show me my Plex watchlist", "what's my request quota", "check playback data", "there's an issue with this show", "report a problem with this movie", or mentions Overseerr, TMDB IDs, Radarr/Sonarr request management, or managing a Plex media library. Also appropriate when the user discovers a movie or show during research and wants to request it, or needs to manage, approve, troubleshoot, browse, delete, or update media requests.
npx claudepluginhub jmagar/claude-homelab --plugin overseerr-mcpHow this skill is triggered — by the user, by Claude, or both
Slash command
/overseerr-mcp:overseerrThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Credentials: `~/.config/overseerr-mcp/.env` (or `~/.config/overseerr-mcp/.env`). Run the `config-media-stack` skill to configure automatically.
Queries Plex Media Server API to browse libraries (movies, TV), search media, check active sessions, view recently added and on-deck content. Invoke on Plex mentions.
Searches Pirate Bay torrents via apibay.org API, extracts magnet links using CLI (season, smart, grab) or direct calls. For torrent searches, seeders, top lists.
Mandates invoking relevant skills via tools before any response in coding sessions. Covers access, priorities, and adaptations for Claude Code, Copilot CLI, Gemini CLI.
Share bugs, ideas, or general feedback.
Credentials: ~/.config/overseerr-mcp/.env (or ~/.config/overseerr-mcp/.env). Run the config-media-stack skill to configure automatically.
OVERSEERR_URL="https://overseerr.example.com"
OVERSEERR_API_KEY="<your_api_key>"
OVERSEERR_URL: Your Overseerr server URL (no trailing slash)OVERSEERR_API_KEY: API key from Overseerr Settings → General → API KeyMCP mode (preferred): Use when mcp__overseerr-mcp__* tools are available. The overseerr-mcp server runs as an HTTP service; its URL is configured via overseerr_mcp_url in the plugin config UI (default: http://overseerr-mcp:9151).
HTTP fallback mode: Use when MCP tools are not loaded. Use bash skills/overseerr/scripts/overseerr-api — credentials are loaded automatically from ~/.config/overseerr-mcp/.env via load-env.
| Tool | Parameters |
|---|---|
mcp__overseerr-mcp__search_media | query (required), media_type ("movie"|"tv", optional) |
mcp__overseerr-mcp__get_movie_details | tmdb_id (required) |
mcp__overseerr-mcp__request_movie | tmdb_id (required) |
mcp__overseerr-mcp__get_tv_show_details | tmdb_id (required) |
mcp__overseerr-mcp__request_tv_show | tmdb_id (required), seasons (optional list e.g. [1,2,3] — omit for all) |
mcp__overseerr-mcp__list_failed_requests | count (optional, default 10), skip (optional, default 0) |
search_media returns results with tmdbId, title, mediaType, year, and current request status.
search_media to find TMDB IDget_movie_details or get_tv_show_details to confirm and check statusrequest_movie or request_tv_showrequest <id> to check approval status afterwardsbash skills/overseerr/scripts/overseerr-api search "The Matrix"
# Raw JSON (for piping to jq):
bash skills/overseerr/scripts/overseerr-api search-json "The Matrix"
bash skills/overseerr/scripts/overseerr-api movie 603
bash skills/overseerr/scripts/overseerr-api tv 1399
bash skills/overseerr/scripts/overseerr-api request-movie 603
bash skills/overseerr/scripts/overseerr-api request-tv 1399 # all seasons
bash skills/overseerr/scripts/overseerr-api request-tv 1399 --season 1 --season 2
bash skills/overseerr/scripts/overseerr-api failed-requests
bash skills/overseerr/scripts/overseerr-api failed-requests --take 20 --skip 20
bash skills/overseerr/scripts/overseerr-api failed-requests --sort modified
bash skills/overseerr/scripts/overseerr-api request <request-id>
Use this to check whether a submitted request has been approved, pending, or failed.
For the full command list — including requests, approve, decline, discover-movies, trending, users, issues, and more — see Quick Reference.
tmdb_id values--season is omittedapprove, decline, retry, and update-request are script-only — there are no MCP equivalents for these operations; switch to HTTP fallback mode when managing requestsWhen running script commands via the zsh tool, always pass pty: true — without it, command output will be suppressed even though the command executes successfully.