Plex

# Clone the repository git clone https://github.com/niavasha/plex-mcp-server.git cd plex-mcp-server # Install dependencies npm install # Build the project npm run build

-

Configure your MCP client(e.g., Claude Desktop):

In v1.0.x there were three separate server binaries (build/index.js,build/plex-trakt-server.js,build/plex-arr-server.js). In v1.1.0+ these are replaced by a single unified binary:build/plex-mcp-server.js.

The old binaries still work but emit a deprecation warning. Update your MCP config to point tobuild/plex-mcp-server.jsand remove any duplicate server entries.

Once configured, you can ask your AI assistant:

"What movies did I watch last week?" "Show me my most popular TV shows this month" "Give me viewing statistics for the past 30 days" "Search for Night of the Living Dead in my library" "What's on my continue watching list?" "List all my Plex libraries" "Add that new show to Sonarr" "What's in my Radarr download queue?" "Sync my Plex history to Trakt"

- Set up Trakt credentials (see above)
- Ask:"Authenticate with Trakt"— follow the OAuth flow
- Ask:"Do a dry run sync of my Plex history to Trakt"— preview what would sync
- Ask:"Sync my Plex watch history to Trakt"— run the actual sync
- Ask:"Search Sonarr for The Beverly Hillbillies"— find the TVDB ID
- Ask:"Add The Beverly Hillbillies to Sonarr"— it auto-detects quality profiles and root folders
- Ask:"What's in my Sonarr download queue?"— monitor progress
- Ask:"Recommend me some movies from my library"
- The engine analyzes your watch history — genres, directors, actors, ratings
- Scores every unwatched movie and returns the top matches with reasons
- For multi-user servers, specify the user:"Recommend movies for Titus"
- If Trakt is configured, it automatically uses your Trakt history too — catching movies you watched outside Plex (other platforms, before tracking was set up)
- Ask:"Show me my Plex viewing stats for the last 30 days"
- Ask:"What are my Trakt stats?"— see lifetime stats (movies watched, hours, milestones)
- Ask:"What are my most popular movies this month?"

46 tools out of the box (58 with write operations enabled).

SetPLEX_ENABLE_MUTATIVE_OPS=trueto enable these tools. They allow your AI assistant to make changes to your Plex server.Use with care— while we test these tools, there are no guarantees. Review changes your assistant proposes before confirming.
- Open Plex Web Appin your browser
- Navigate to Settings> Account > Privacy
- Click "Show Advanced"at the bottom
- Copy your Plex Token

- Visit:http://YOUR_PLEX_IP:32400/web/index.html#!/settings/account
- Look for the "Plex Token" field

plex-mcp-server/ ├── src/ │ ├── plex-mcp-server.ts # Unified server entry point (44+ tools) │ ├── index.ts # Deprecated shim → plex-mcp-server │ ├── plex-arr-server.ts # Deprecated shim → plex-mcp-server │ ├── plex-trakt-server.ts # Deprecated shim → plex-mcp-server │ ├── plex/ # Shared Plex module │ │ ├── client.ts # Plex API client │ │ ├── tools.ts # Plex tool implementations │ │ ├── tool-registry.ts # Map-based tool dispatch │ │ ├── tool-schemas.ts # MCP tool schema definitions │ │ ├── constants.ts # Configuration defaults │ │ └── types.ts # TypeScript type definitions │ ├── arr/ # Sonarr/Radarr module │ │ ├── client.ts # Base ArrClient + Sonarr/Radarr subclasses │ │ ├── mcp-functions.ts # Tool implementations (17 tools) │ │ ├── tool-registry.ts # Map-based tool dispatch │ │ ├── tool-schemas.ts # MCP tool schema definitions │ │ ├── constants.ts # Configuration defaults │ │ └── types.ts # TypeScript type definitions │ ├── trakt/ # Trakt.tv module │ │ ├── client.ts # Trakt API client + OAuth │ │ ├── sync.ts # Plex-to-Trakt sync engine │ │ ├── mapper.ts # Plex-to-Trakt data mapping │ │ ├── mcp-functions.ts # Tool implementations (9 tools) │ │ ├── tool-registry.ts # Map-based tool dispatch │ │ └── tool-schemas.ts # MCP tool schema definitions │ ├── shared/ # Shared utilities │ │ └── utils.ts # truncate, sleep, chunkArray │ └── __tests__/ # Test suite (94 tests) ├── build/ # Compiled JavaScript output ├── docs/ # Documentation ├── package.json ├── tsconfig.json ├── vitest.config.ts ├── .env.example # Environment variables template └── README.md

# Development mode with auto-reload npm run dev # Build for production npm run build # Start production server npm start # Run tests npm test npm run test:watch

git clone https://github.com/niavasha/plex-mcp-server.git cd plex-mcp-server npm install npm run dev

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

- Verify your Plex server is running
- Check thePLEX_URLin your environment config
- Ensure the port (usually 32400) is correct

Host unreachable (EHOSTUNREACH/ connect errors) on macOS:

- On macOS Sequoia, Sonoma, or later, connections to local IP addresses (like10.0.0.10or192.168.1.50) may be blocked byLocal Network Privacysettings.
- Workaround 1:Try connecting using the local hostname (e.g.,plex.localor your Plex server name) rather than the direct IP address. Alternatively, use a Plex*.plex.directdomain.
- Workaround 2:Go toSystem Settings -> Privacy & Security -> Local Networkon your Mac and ensure that the MCP client (e.g., Claude Desktop, Terminal, or VS Code) is enabled and has permission to access the local network.

- Verify your Plex token is correct
- Check token permissions in Plex settings
- Ensure token hasn't expired

- Some features require Plex Pass
- Check if your libraries are accessible
- Verify media has been scanned and is available

- Verify Sonarr/Radarr is running and accessible from the MCP server host
- Check that the API key is correct (Settings > General > API Key)
- Sonarr uses API v3 at/api/v3/— ensure your URL doesn't include a trailing path
- For large Radarr libraries (20k+ movies), the initialradarr_get_moviescall may take up to 30 seconds

- EnsureTRAKT_CLIENT_IDandTRAKT_CLIENT_SECRETare both set
- Use thetrakt_authenticatetool to start the OAuth flow
- Complete authentication withtrakt_complete_authusing the code from Trakt

- Ensure the path is set tobuild/plex-mcp-server.js(the unified server)
- Check that Node.js is in your system PATH
- Verify environment variables are set in client config

- Node.js20.0.0 or higher
- Plex Media Server(any recent version)
- Network accessbetween MCP server and Plex server
- Valid Plex tokenwith appropriate permissions

- Keep your Plex token secure- never commit it to version control
- Use environment variablesfor sensitive configuration
- Run on trusted networks- the server communicates directly with Plex
- Regular token rotation- consider refreshing tokens periodically
- Write operationsare disabled by default — enable only if you trust your AI assistant's judgment

Built with love for the Plex and AI community

MCP server for Google Cast — discover devices, play media, control volume, launch apps, and manage queues over stdio

Generates dog images with an LGTM (Looks Good To Me) overlay using the Dog CEO API.

A virtual travel environment for an avatar on Google Maps, utilizing various Google Maps and optional AI image generation APIs.

An integration for Claude Desktop to interact with Spotify using the Model Context Protocol (MCP).

Control a media player via Home Assistant.

Access real-time entertainment data and personal viewing history from the Trakt.tv API.

Tracks movies, books, and TV shows to provide intelligent recommendations based on your preferences.

A soundboard MCP server with millions of meme sounds from myinstants.com — search, play, and browse categories. npx myinstants-mcp to get started.

PaKi Curator — Visual Medicine Art Catalog

MCP server for César Yagüe's Visual Medicine — 301 contemplative moving art works (seamless loops up to 16K), 109 vibrational capsules, 6 tools including spatial recommendations and direct artist inquiry.