MCP server for *arr media management suite
# Add to your Claude Code skills
git clone https://github.com/aplaceforallmystuff/mcp-arrGuides for using mcp servers skills like mcp-arr.
Last scanned: 5/30/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-30T16:09:36.964Z",
"npmAuditRan": true,
"pipAuditRan": true
}mcp-arr is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by aplaceforallmystuff. MCP server for *arr media management suite. It has 163 GitHub stars.
Yes. mcp-arr passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/aplaceforallmystuff/mcp-arr" and add it to your Claude Code skills directory (see the Installation section above).
mcp-arr is primarily written in JavaScript. It is open-source under aplaceforallmystuff on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh mcp-arr against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars

MCP server for the *arr media management suite - Sonarr, Radarr, Lidarr, and Prowlarr.
Supports both local stdio mode for Claude/Codex-style clients and remote HTTP mode for hosted MCP clients such as ChatGPT connectors.
| Category | Capabilities |
|---|---|
| Sonarr (TV) | List series, view episodes, search shows, trigger downloads, check queue, view calendar, review setup |
| Radarr (Movies) | List movies, search films, trigger downloads, check queue, view releases, review setup |
| Lidarr (Music) | List artists, view albums, search musicians, trigger downloads, check queue, view calendar, review setup |
| Prowlarr (Indexers) | List indexers, search across all trackers, test health, view statistics |
| Cross-Service | Status check, unified search across all configured services |
| Configuration | Quality profiles, download clients, naming conventions, health checks, storage info |
| TRaSH Guides | Reference quality profiles, custom formats, naming conventions, compare against recommendations |
npx mcp-arr-server
MCP_TRANSPORT=http PORT=3000 npx mcp-arr-server
By default the remote server listens on 127.0.0.1:3000 and serves MCP on /mcp.
Environment variables for remote mode:
MCP_TRANSPORT=http to enable remote Streamable HTTP transportHOST to override the bind host (default 127.0.0.1)PORT to override the port (default 3000)MCP_PATH to override the MCP endpoint path (default /mcp)Build locally:
docker build -t mcp-arr .
Run in local stdio mode:
docker run --rm -i \
-e SONARR_URL=http://host.docker.internal:8989 \
-e SONARR_API_KEY=your-sonarr-api-key \
mcp-arr
Run in remote HTTP mode:
docker run --rm -p 3000:3000 \
-e MCP_TRANSPORT=http \
-e HOST=0.0.0.0 \
-e PORT=3000 \
-e SONARR_URL=http://host.docker.internal:8989 \
-e SONARR_API_KEY=your-sonarr-api-key \
mcp-arr
Minimal docker-compose.yml:
services:
mcp-arr:
build: .
ports:
- "3000:3000"
environment:
MCP_TRANSPORT: http
HOST: 0.0.0.0
PORT: 3000
SONARR_URL: http://host.docker.internal:8989
SONARR_API_KEY: your-sonarr-api-key
RADARR_URL: http://host.docker.internal:7878
RADARR_API_KEY: your-radarr-api-key
git clone https://github.com/aplaceforallmystuff/mcp-arr.git
cd mcp-arr
npm install
npm run build
Each *arr application has an API key in Settings > General > Security:
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"arr": {
"command": "npx",
"args": ["-y", "mcp-arr-server"],
"env": {
"SONARR_URL": "http://localhost:8989",
"SONARR_API_KEY": "your-sonarr-api-key",
"RADARR_URL": "http://localhost:7878",
"RADARR_API_KEY": "your-radarr-api-key",
"LIDARR_URL": "http://localhost:8686",
"LIDARR_API_KEY": "your-lidarr-api-key",
"PROWLARR_URL": "http://localhost:9696",
"PROWLARR_API_KEY": "your-prowlarr-api-key"
}
}
}
}
Add to ~/.claude.json:
{
"mcpServers": {
"arr": {
"command": "npx",
"args": ["-y", "mcp-arr-server"],
"env": {
"SONARR_URL": "http://localhost:8989",
"SONARR_API_KEY": "your-sonarr-api-key",
"RADARR_URL": "http://localhost:7878",
"RADARR_API_KEY": "your-radarr-api-key"
}
}
}
}
Note: Only configure the services you have running. The server automatically detects which services are available based on the environment variables you provide.
TRaSH-only mode: if you don’t configure any *arr services, the server still starts and exposes the TRaSH Guides reference tools plus generic search and fetch.
To use mcp-arr with ChatGPT, run the server in remote HTTP mode on a reachable host and connect ChatGPT to the /mcp endpoint.
The server now exposes the generic search and fetch tools expected by ChatGPT-style remote MCP integrations:
search discovers matching *arr media and TRaSH profilesfetch returns structured detail for a selected search resultThe existing service-specific tools remain available for richer local or power-user workflows.
| Tool | Description |
|---|---|
arr_status |
Get connection status for all configured *arr services |
arr_search_all |
Search across all configured services simultaneously |
search |
Generic discovery tool for remote MCP clients such as ChatGPT |
fetch |
Generic detail-fetch tool for items returned by search |
| Tool | Description |
|---|---|
sonarr_get_series |
List all TV series in your library |
sonarr_search |
Search for TV series by name (returns tvdbId for adding) |
sonarr_add_series |
Add a TV series to Sonarr (supports tags) |
sonarr_get_root_folders |
Get available root folders for adding series |
sonarr_get_quality_profiles |
Get available quality profiles for adding series |
sonarr_get_queue |
View current download queue with limit and offset pagination |
sonarr_get_calendar |
See upcoming episodes |
sonarr_get_episodes |
List episodes for a series (shows missing vs available) |
sonarr_search_missing |
Trigger search for all missing episodes in a series |
sonarr_search_episode |
Trigger search for specific episode(s) |
| Tool | Description |
|---|---|
radarr_get_movies |
List all movies in your library |
radarr_search |
Search for movies by name (returns tmdbId for adding) |
radarr_add_movie |
Add a movie to Radarr (supports tags) |
radarr_get_root_folders |
Get available root folders for adding movies |