MCP Arr
MCP server for *arr media management suite
What is MCP Arr?
MCP Arr is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for *arr media management suite
MCP server for *arr media management suite
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- arr_status
- sonarr_get_quality_profiles
- sonarr_get_health
- sonarr_get_root_folders
- sonarr_get_download_clients
Use Cases
Maintainer
Works with
Installation
NPM
npx -y mcp-arr-serverManual Installation
npx -y mcp-arr-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Arr
MCP Arr Server provides a unified natural-language interface to the *arr media management suite — Sonarr, Radarr, Lidarr, Prowlarr, and Readarr — through the Model Context Protocol. Instead of navigating multiple web UIs, you can ask your AI assistant to search for TV shows, trigger movie downloads, browse music libraries, monitor download queues, and check upcoming release calendars across all your *arr applications in a single conversation. The server supports both local stdio and remote HTTP transports, making it flexible for home lab and self-hosted deployments.
Prerequisites
- Node.js 18+ installed
- At least one *arr application running (Sonarr, Radarr, Lidarr, Prowlarr, or Readarr) with API access enabled
- API keys for each *arr instance you want to control (found in each app's Settings > General)
- An MCP-compatible client such as Claude Desktop or Cursor
Note your *arr API keys and URLs
In each *arr application, navigate to Settings > General and copy the API Key and the base URL (e.g., http://localhost:8989 for Sonarr). You will need these for the environment variables.
Add the server to your MCP client configuration
Register mcp-arr-server in your claude_desktop_config.json. Provide the URL and API key for each *arr app you want to connect. You can connect as many or as few as you have running.
{
"mcpServers": {
"mcp-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"
}
}
}
}Restart your MCP client
Quit and relaunch Claude Desktop (or reload the server list in your client). Tools like arr_status, sonarr_get_health, and radarr search tools should become available.
Verify connectivity with a status check
Ask your AI assistant to check the status of your *arr applications to confirm all connections are working.
Optional: run in HTTP mode for remote access
If you want to connect remotely rather than via stdio, run the server in HTTP mode.
MCP_TRANSPORT=http PORT=3000 npx mcp-arr-serverMCP Arr Examples
Client configuration
claude_desktop_config.json connecting to Sonarr and Radarr via the mcp-arr-server.
{
"mcpServers": {
"mcp-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"
}
}
}
}Prompts to try
Natural-language prompts for managing your media library through the *arr suite.
- "Show me the health status of all my *arr applications"
- "List all TV series currently in my Sonarr library"
- "Search for the show 'Severance' in Sonarr and add it to my library"
- "What movies are downloading right now in Radarr?"
- "What quality profiles do I have configured in Sonarr?"Troubleshooting MCP Arr
Connection refused when trying to reach a *arr application
Confirm the *arr app is running and accessible at the URL you configured. If running in Docker, use the container's internal IP or hostname rather than localhost when the MCP server also runs in Docker. Test the URL directly in a browser first.
API authentication error (401 Unauthorized)
Double-check the API key in each *arr app's Settings > General page. Keys are long alphanumeric strings — ensure the full key is copied without truncation. Restart the *arr application after noting the key to ensure it is active.
Only some *arr apps respond; others return no data
Each *arr app requires its own URL and API key pair. Confirm that RADARR_URL/RADARR_API_KEY, SONARR_URL/SONARR_API_KEY, etc., are all correctly set for each application you have running. Apps with missing env vars are simply not connected.
Frequently Asked Questions about MCP Arr
What is MCP Arr?
MCP Arr is a Model Context Protocol (MCP) server that mcp server for *arr media management suite It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Arr?
Install via npm with the command: npx -y mcp-arr-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with MCP Arr?
MCP Arr works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Arr free to use?
Yes, MCP Arr is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Arr Alternatives — Similar Business Applications Servers
Looking for alternatives to MCP Arr? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Arr in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Arr?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.