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.
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 |
| Upcoming album releases |
| Health warnings |
| Quality profiles |
| Metadata profiles |
| Root folders |
| Download clients |
| Tags |
| System status |
Readarr (Books)
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 |
| 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 outputThis server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- 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