Plex MCP Server
MCP Server for Plex to allow LLMs to converse with Plex.
Overview
Plex MCP Server is a Multi-Chat-Provider integration for Plex Media Server that allows AI assistants to interact with Plex libraries, manage content, and control playback.
To use Plex MCP Server, clone the repository, install dependencies, configure environment variables, and run the server. You can then use various commands to manage your Plex library and playback.
- Library Management: Browse and search Plex libraries. - Media Playback: Control playback on Plex clients. - Content Discovery: Search for media and view recently added content. - Metadata Management: Edit media metadata. - User Management: View user activity and information. - Collection & Playlist Management: Create and manage collections and playlists. - Server Monitoring: View active sessions and server status.
- Managing a large media library with ease.
- Automating media playback through AI assistants.
- Customizing media metadata for better organization.
- Monitoring server activity and user engagement.
Add to your AI client
Use these steps to connect Plex MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"plex-mcp-server-vladimir-tutin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-plex-mcp-server-vladimir-tutin"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"plex-mcp-server-vladimir-tutin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-plex-mcp-server-vladimir-tutin"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"plex-mcp-server-vladimir-tutin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-plex-mcp-server-vladimir-tutin"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"plex-mcp-server-vladimir-tutin": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-plex-mcp-server-vladimir-tutin"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"plex-mcp-server-vladimir-tutin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-plex-mcp-server-vladimir-tutin"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"plex-mcp-server-vladimir-tutin": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-plex-mcp-server-vladimir-tutin"
]
}
}
}FAQ
What are the prerequisites for using Plex MCP Server?
You need a Plex Media Server, a Plex account with admin privileges, Python 3.8+, and an AI assistant that supports the MCP protocol.
How do I install Plex MCP Server?
Clone the repository, install dependencies, configure environment variables, and run the server.
Can I use Plex MCP Server with any AI assistant?
Yes, as long as the AI assistant supports the MCP protocol.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3624,"uuid":"424078b4-6092-492c-9770-fd04c30d090a","name":"plex-mcp-server","title":"Plex MCP Server","description":"MCP Server for Plex to allow LLMs to converse with Plex.","avatar_url":"https://avatars.githubusercontent.com/u/14234678?v=4","created_at":"2025-03-20T16:41:22.704Z","updated_at":"2025-03-20T17:05:05.892Z","status":"created","author_name":"vladimir-tutin","author_avatar_url":"https://avatars.githubusercontent.com/u/14234678?v=4","tags":"[]","category":"research-and-data","is_featured":false,"sort":1,"url":"https://github.com/vladimir-tutin/plex-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"3\",\"license\":\"\",\"language\":\"Python\",\"is_official\":false,\"latest_commit_time\":\"2025-03-25 01:14:18\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]