Plex MCP Server
README.md
# Plex MCP server for ChatGPT and Claude
Connect ChatGPT, Claude and other AI agents to Plex through Cotlet.dev. The live integration page describes 14 hosted Plex operations for libraries, Watchlist titles, watched state, playlists and library access. Plex has a documented Media Server API and no official MCP server according to that page, checked 6 November 2026.
## What you can ask
> Compare my Watchlist with my Plex libraries.
> Find unwatched movies in my Movies library.
> Mark a finished series as watched.
> Build a themed playlist from titles in my libraries.
> Prepare a library invitation for my approval.
## Connect Plex
Start at https://cotlet.dev/signup?app=plex, sign in to Plex in its Cloud Browser and enable it for agents. For editors and scripts, create your API key in the Cotlet.dev console and export it as `COTLET_API_KEY`.
### ChatGPT
Add `https://cotlet.dev/mcp/v1/connect` as a connector and sign in with Cotlet.dev.
### Claude
Add `https://cotlet.dev/mcp/v1/connect` in Settings > Connectors and sign in with Cotlet.dev.
### Claude Code
```bash
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
```
### Cursor
Copy `.cursor/mcp.json` from this repo into your project:
```json
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}
```
## Local browser adapter (stdio)
This repo contains a local MCP adapter for the hosted Cotlet.dev Cloud Browser. The seven local browser helpers below are distinct from the 14 Plex operations documented on the integration page. It speaks MCP over stdio, lists its Plex tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
Run the adapter directly from this repository:
```bash
export COTLET_API_KEY="your-key"
python3 plex_agent.py serve
```
Or with Docker:
```bash
docker build -t plex-mcp .
docker run -i --rm -e COTLET_API_KEY plex-mcp
```
Tools: `plex_guide`, `plex_status`, `plex_open`, `plex_read`, `plex_click`, `plex_type`, `plex_close`. Without `COTLET_API_KEY` a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
## Command line
Python 3.10+, using the standard library. From this repository:
```bash
export COTLET_API_KEY="your-key"
python3 plex_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 plex_agent.py status # is Plex ready in your Cotlet.dev account
python3 plex_agent.py guide # Plex screens and sign-in link
python3 plex_agent.py read # open Plex, read the page, close the browser
python3 plex_agent.py tools # list Cotlet.dev tools
python3 plex_agent.py serve # start the stdio MCP server (same as no argument)
```
## Questions from Plex users
**Does Plex have an API or official MCP server?**
Plex has a documented Media Server API and no official MCP server according to the Cotlet.dev page, checked 6 November 2026. The API covers library tasks; its documentation lists no Watchlist or library sharing category.
**Who can manage library access?**
Only the server owner can manage access. Granting or revoking library access asks for approval by default. Watchlist, watched state and playlist changes run immediately.
**Does this connection play media?**
No. These operations browse, search and manage Plex. Your server must be online and reachable as it is for Plex Web away from home; Watchlist tasks work without a server.
**Is this an official Plex integration?**
No. Cotlet.dev is independent and is not affiliated with Plex.
## Source
https://cotlet.dev/integrations/plex-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=plex
Start here: https://cotlet.dev/signup?app=plex