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.
Tools
Radarr (Movies)
Tool | Description |
| List all movies |
| Search for a movie by title |
| Add a movie by TMDB ID |
| Delete a movie (optionally with files) |
| View download queue |
| Health check |
| List quality profiles |
| List root folders |
| System status |
Sonarr (TV Shows)
Tool | Description |
| List all series |
| Search for a series by title |
| Add a series by TVDB ID |
| Delete a series (optionally with files) |
| List episodes for a series |
| View download queue |
| Health check |
| List quality profiles |
| List root folders |
| System status |
Lidarr (Music)
Tool | Description |
| List all artists |
| Search for an artist |
| Add an artist by MusicBrainz ID |
| List albums (optionally by artist) |
| Health check |
| List quality profiles |
| List root folders |
| System status |
Readarr (Books)
Tool | Description |
| List all authors |
| Search for an author |
| Add an author by foreign ID |
| List books (optionally by author) |
| Search for a book by title/ISBN |
| Health check |
| List quality profiles |
| List root folders |
| System status |
Prowlarr (Indexers)
Tool | Description |
| List all configured indexers |
| Search across indexers |
| Indexer statistics |
| Health check |
| System status |
Related MCP server: Mediabox MCP
Setup
1. Install & Build
npm install
npm run build2. Configure Environment
Copy .env.example to .env and fill in your service URLs and API keys. You only need to configure the services you use — unconfigured services are simply unavailable.
API keys are found in each app under Settings → General → Security → API Key.
3. Wire Up in Claude Desktop (or any MCP client)
Add to your MCP client config (e.g. claude_desktop_config.json):
{
"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": "...",
"PROWLARR_URL": "http://localhost:9696",
"PROWLARR_API_KEY": "..."
}
}
}
}Or with npx / tsx for development:
{
"mcpServers": {
"arr": {
"command": "npx",
"args": ["tsx", "/path/to/arr-mcp/src/index.ts"],
"env": { ... }
}
}
}Docker
Build & run with Docker Compose
cp .env.example .env
# vul je keys in .env
docker compose up --buildOf direct via Docker
docker build -t arr-mcp .
docker run --rm -i \
-e RADARR_URL=http://192.168.1.x:7878 \
-e RADARR_API_KEY=abc123 \
-e SONARR_URL=http://192.168.1.x:8989 \
-e SONARR_API_KEY=abc123 \
arr-mcpMCP client config (Docker)
{
"mcpServers": {
"arr": {
"command": "docker",
"args": ["run", "--rm", "-i",
"-e", "RADARR_URL",
"-e", "RADARR_API_KEY",
"-e", "SONARR_URL",
"-e", "SONARR_API_KEY",
"-e", "PROWLARR_URL",
"-e", "PROWLARR_API_KEY",
"arr-mcp"
],
"env": {
"RADARR_URL": "http://localhost:7878",
"RADARR_API_KEY": "...",
"SONARR_URL": "http://localhost:8989",
"SONARR_API_KEY": "...",
"PROWLARR_URL": "http://localhost:9696",
"PROWLARR_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.
Development
npm install
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
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