Arr-MCP
Provides tools for managing movies in Radarr, including listing, searching, adding, deleting, and viewing queue, health, quality profiles, root folders, and system status.
Provides tools for managing TV series in Sonarr, including listing, searching, adding, deleting, viewing episodes, queue, health, quality profiles, root folders, and system status.
Click on "Install 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., "@Arr-MCPsearch for the movie Inception"
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.
Arr-MCP
An MCP server for your *ARR stack — Radarr, Sonarr, Lidarr, Readarr, and Prowlarr.
Readarr is retired by upstream (since May 2024) — its tools still work but metadata may be unreliable. See Readarr status.
Supports stdio (local, Claude Desktop) and HTTP/Streamable HTTP (remote, ChatGPT, any MCP-compatible client).
Tools
Cross-service
Tool | Description |
| Show which services are configured |
| Search all configured services at once |
Radarr (Movies)
Tool | Description |
| List movies (paginated) |
| Search by title |
| Add by TMDB ID |
| Update monitored/quality profile |
| Delete (optionally with files) |
| Trigger download search for a movie |
| Refresh metadata |
| Download queue (paginated) |
| Remove item from queue |
| Upcoming releases |
| Health warnings |
| Quality profiles |
| Root folders |
| Download clients |
| Tags |
| File naming config |
| System status |
Sonarr (TV Shows)
Tool | Description |
| List series (paginated) |
| Search by title |
| Add by TVDB ID |
| Delete (optionally with files) |
| Refresh metadata |
| List episodes (optionally by season) |
| Trigger search for missing episodes |
| Trigger search for a specific episode |
| Download queue (paginated) |
| Remove item from queue |
| Upcoming air dates |
| Health warnings |
| Quality profiles |
| Root folders |
| Download clients |
| Tags |
| File naming config |
| System status |
Lidarr (Music)
Tool | Description |
| List artists (paginated) |
| Search by name |
| Add by MusicBrainz ID |
| List albums (optionally by artist, paginated) |
| Trigger search for missing albums |
| Get available releases for an album |
| Grab a specific release by GUID |
| Download history (grabs, imports, failures) |
| Blocklist |
| Remove item from blocklist |
| Monitored albums with no file |
| Download queue (paginated) |
| Remove item from queue |
| Disk space per root folder |
| Check status of a triggered command |
| Upcoming album releases |
| Health warnings |
| Quality profiles |
| Metadata profiles |
| Root folders |
| Download clients |
| Tags |
| System status |
Readarr (Books) — ⚠️ retired upstream
Tool | Description |
| List authors (paginated) |
| Search by name |
| Add by Goodreads ID |
| List books (optionally by author, paginated) |
| Search by title or ISBN |
| Health warnings |
| Quality profiles |
| Root folders |
| System status |
Prowlarr (Indexers)
Tool | Description |
| List indexers |
| Test a specific indexer |
| Test all indexers |
| Search across indexers |
| Grab a release found via search |
| Indexer statistics |
| Health warnings |
| System status |
Related MCP server: nas-mcp-server
Setup
1. Install & Build
npm install
npm run build2. Configure
Copy .env.example to .env and fill in your service URLs and API keys. Only configure the services you use — unconfigured services are skipped at startup and their tools don't appear.
API keys: Settings → General → Security → API Key in each app.
Transport modes
stdio — local (Claude Desktop)
Default mode. The MCP client launches the process directly.
{
"mcpServers": {
"arr": {
"command": "node",
"args": ["/path/to/arr-mcp/dist/index.js"],
"env": {
"RADARR_URL": "http://localhost:7878",
"RADARR_API_KEY": "...",
"SONARR_URL": "http://localhost:8989",
"SONARR_API_KEY": "..."
}
}
}
}HTTP — remote (ChatGPT, hosted clients)
Set MCP_TRANSPORT=http. The server listens on http://HOST:PORT/mcp and accepts POST requests per the MCP Streamable HTTP spec.
MCP_TRANSPORT=http MCP_PORT=3000 \
RADARR_URL=http://... RADARR_API_KEY=... \
node dist/index.jsA GET /health endpoint is also available for uptime checks.
Docker
Het gepubliceerde image staat op GitHub Container Registry:
ghcr.io/ltmarx/arr-mcp:latestDe docker-compose.yml heeft twee profielen — stdio en http — die nooit tegelijk actief zijn.
HTTP mode — remote/persistent server
cp .env.example .env # vul je keys in
docker compose --profile http upDe server luistert op http://<host>:3000/mcp. Poort aanpassen: MCP_PORT=8080 docker compose --profile http up.
Controleer of de server draait:
curl http://localhost:3000/health
# → {"status":"ok","transport":"http"}Stdio mode — lokaal (Claude Desktop)
docker compose --profile stdio upOf direct via docker run (wordt gestart door de MCP client):
docker run --rm -i \
-e RADARR_URL=http://192.168.1.x:7878 \
-e RADARR_API_KEY=abc123 \
ghcr.io/ltmarx/arr-mcp:latestMCP client config voor Claude Desktop:
{
"mcpServers": {
"arr": {
"command": "docker",
"args": ["run", "--rm", "-i",
"-e", "RADARR_URL", "-e", "RADARR_API_KEY",
"-e", "SONARR_URL", "-e", "SONARR_API_KEY",
"ghcr.io/ltmarx/arr-mcp:latest"
],
"env": {
"RADARR_URL": "http://localhost:7878",
"RADARR_API_KEY": "...",
"SONARR_URL": "http://localhost:8989",
"SONARR_API_KEY": "..."
}
}
}
}Tip: Als je *ARR draait op de host machine gebruik dan
host.docker.internal(Mac/Windows) of het host IP-adres in plaats vanlocalhost.
Releases
Releases worden automatisch gepubliceerd via GitHub Actions. Maak een tag aan op GitHub (v1.0.0) en publiceer een Release — het multi-arch image (amd64 + arm64) verschijnt vanzelf op GHCR.
Development
npm run dev # run met tsx (geen build stap)
npm run build # compileer naar dist/
npm start # run gecompileerde outputMaintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Related MCP Servers
- AlicenseAqualityBmaintenanceAn MCP server for the Servarr stack — Sonarr, Radarr, Lidarr, Readarr, and Prowlarr — packaged as a Docker container. Lets an MCP client (Claude Desktop, etc.) browse and search whichever \*arr apps you're running.Last updated29MIT
- AlicenseAqualityDmaintenanceMCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.Last updated12MIT
- Flicense-qualityBmaintenanceMCP server for Overseerr that enables searching, requesting, and managing media (movies and TV shows) through natural language, with integration to Radarr/Sonarr for automated downloads.Last updated
- Alicense-qualityBmaintenanceEnables interaction with the *arr media management suite (Sonarr, Radarr, Lidarr, Prowlarr, SABnzbd) and TRaSH Guides through MCP tools, allowing media library management, searching, and configuration via natural language.Last updated161MIT
Related MCP Connectors
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
MCP server for the FFmpeg Micro video transcoding API — create, monitor, download transcodes.
MCP server for accessing curated awesome list documentation
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/LtMarx/Arr-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server