MCP Arr Stack

MCP server that gives Claude Code direct access to your *arr media stack and Plex. Search, browse, request, and monitor media from the command line without opening a browser.

Why build this?

Radarr, Sonarr, Overseerr, SABnzbd, and Plex all have web UIs, but switching between five browser tabs to check download status, search for a movie, or request a show is friction. This MCP server exposes the key operations as Claude Code tools so you can manage your media stack through natural language in the terminal.

What it does

Radarr: Search movies, view library, check download queue, add movies by TMDB ID
Sonarr: Search series, view library, check download queue, add series by TVDB ID
Overseerr: Search all media, request movies/TV, view pending requests
SABnzbd: View download queue and history, pause/resume downloads, check server status
Plex: Browse libraries, search media, view recently added, check active sessions, delete items

Stack

Python 3.13 + FastMCP (SSE transport)
httpx for async API calls
Docker container

Setup

Copy .env.example to .env and fill in your API keys and service URLs:
```
cp .env.example .env
```
Get API keys from each service:
- Radarr: Settings > General > API Key
- Sonarr: Settings > General > API Key
- Overseerr: Settings > General > API Key
- SABnzbd: Config > General > API Key
- Plex: See Finding your Plex token
Build and run:
```
docker compose up -d --build
```

claude mcp add arr-stack --transport sse --url http://your-server:3695/sse

Available tools

| Tool | Description | |------|-------------| | radarr_search | Search movies by title | | radarr_library | List all movies in library | | radarr_queue | View active movie downloads | | radarr_add | Add movie by TMDB ID | | sonarr_search | Search TV series by title | | sonarr_library | List all series in library | | sonarr_queue | View active series downloads | | sonarr_add | Add series by TVDB ID | | overseerr_search | Search movies and TV | | overseerr_request_movie | Request a movie | | overseerr_request_tv | Request a TV show (all or specific seasons) | | overseerr_requests | View recent requests | | sabnzbd_queue | View download queue | | sabnzbd_history | View download history | | sabnzbd_pause | Pause downloads | | sabnzbd_resume | Resume downloads | | sabnzbd_status | Server status and disk space | | plex_libraries | List all Plex libraries | | plex_library_items | Browse items in a library | | plex_search | Search across all libraries | | plex_recently_added | View recently added media | | plex_sessions | View active streaming sessions | | plex_delete | Delete a media item |

Architecture

Claude Code --SSE--> mcp-arr-stack (port 3695) --HTTP--> *arr services
                                                         ├── Radarr
                                                         ├── Sonarr
                                                         ├── Overseerr
                                                         ├── SABnzbd
                                                         └── Plex

Stateless proxy — all state lives in the *arr services themselves. LAN-only by default; no authentication layer since it runs behind your home network.

License

MIT

MCP Servers