This server integrates with Radarr and Sonarr to search for and manage movies and TV shows.
Search Movies – Search for movies by title using Radarr's built-in lookup (
search_movies)Add Movies – Add a specific movie to Radarr using its TMDb ID, with an optional custom root folder path (
add_movie_by_id)Search & Add TV Shows – Search using a natural language description and optionally auto-add to Sonarr if only one result is found (
search_and_add_show)Add TV Shows – Add a specific TV show to Sonarr using its TVDB ID and title, with an optional custom root folder path (
add_show_by_tvdb_id)Test Configuration – Verify configuration and API connectivity for both Radarr and Sonarr (
test_config)Check Server Status – Get the live status of both Radarr and Sonarr instances (
get_server_status)
Connection details (URLs, API keys, quality profiles, root folders) are configured via environment variables, and root folders are auto-detected from Radarr/Sonarr when not explicitly provided.
Enables adding movies to Radarr via natural language queries, with capabilities to search for movies by title and add them by TMDB ID with optional custom root folder specification.
Enables adding TV shows to Sonarr via natural language queries, with capabilities to search for and add shows by description or TVDB ID with optional custom root folder specification.
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-assistant-mcpadd The Matrix to my movie collection"
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-assistant-mcp
MCP server for searching movies and TV shows and adding them to Radarr and Sonarr.
Setup
Requires Python 3.12+ and uv for local development.
git clone <repo>
cd arr-assistant-mcp
uv syncRelated MCP server: Jira MCP Server
Run From Source
Add this to your claude_desktop_config.json to run the checked-out project directly:
{
"mcpServers": {
"arr-assistant": {
"command": "uv",
"args": [
"run",
"--project",
"/path/to/arr-assistant-mcp",
"src/arr_assistant_mcp/main.py"
],
"env": {
"RADARR_URL": "http://your-ip:7878",
"RADARR_API_KEY": "your-radarr-api-key",
"SONARR_URL": "http://your-ip:8989",
"SONARR_API_KEY": "your-sonarr-api-key",
"QUALITY_PROFILE_ID": "1",
"RADARR_ROOT_FOLDER": "/storage/movies",
"SONARR_ROOT_FOLDER": "/storage/shows"
}
}
}
}Trailing slashes in RADARR_URL and SONARR_URL are normalized automatically.
Build An MCP Bundle
Packaged release artifacts should now use the .mcpb extension.
npm install -g @anthropic-ai/mcpb
mcpb validate .
mcpb pack . arr-assistant-mcp.mcpbOpen the resulting .mcpb file in Claude Desktop to install it.
Configuration Notes
Radarr/Sonarr API keys: Settings -> General -> API Key
Quality profile: Use the numeric profile ID from your Radarr or Sonarr instance
Root folders: If omitted, the server auto-detects the first available root folder from each service
TVDB API key: Not required for the current implementation
Tools
test_config()- Test configuration and connectivity for both Radarr and Sonarrsearch_movies(title)- Search for movies by titleadd_movie_by_id(tmdb_id, root_folder=None)- Add a movie to Radarrsearch_and_add_show(description, auto_add=False)- Search for TV shows and optionally auto-add the only match to Sonarradd_show_by_tvdb_id(tvdb_id, title, root_folder=None)- Add a show to Sonarrget_server_status()- Check Radarr and Sonarr status
Usage
search_movies("The Matrix")
add_movie_by_id(603)
# Specify a custom root folder
add_show_by_tvdb_id(123456, "Attack on Titan", "/storage/anime")Root folders are auto-detected from your Radarr and Sonarr configurations when not provided, but can still be overridden per request.