Plex MCP Server enables AI assistants to search, browse, and manage your Plex media libraries. Connect to your Plex server to explore movies, TV shows, music, and other content with natural language queries. Key features of Plex MCP Server: - Natural language search across all Plex libraries for movies, shows, music, and more - Smart music discovery with queries like "songs from the 90s" and "rock bands I haven't heard" - Playlist management including creation, editing, and intelligent randomization - Browse collections, recently added content, and viewing history - Detailed media metadata including codecs, bitrates, file sizes, and watch status - Secure authentication via OAuth or static Plex tokens - Resource-based data access through structured URIs (plex://libraries, plex://playlists, etc.)

Plex MCP Server

Search and manage your Plex media libraries with Claude. Actively developed by Claude and a nerdy human who mostly uses Plex for auditory delights and wanted to see how much could be accomplished without knowing much about what they're doing. Results may vary, but probably in a good way.

Quick Start

Install via Smithery (Recommended)

npx -y @smithery/cli install @vyb1ng/plex-mcp --client claude

Manual Setup for Claude Desktop

Add to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "plex": {
      "command": "npx",
      "args": ["plex-mcp"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400"
      }
    }
  }
}

Authentication

Option 1: OAuth (Recommended)

Option 2: Static Token

Note: Replace your-plex-server:32400 with your actual Plex server address and port.

HTTP Debug Logging

For troubleshooting connection issues, you can enable comprehensive HTTP request/response logging:

{
  "mcpServers": {
    "plex": {
      "command": "npx",
      "args": ["plex-mcp"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400",
        "MCP_HTTP_DEBUG": "true"
      }
    }
  }
}

When MCP_HTTP_DEBUG=true, the server will log:

All logs are structured JSON with correlation IDs for request/response tracking.

What You Can Do

Search & Browse

Music Discovery

Playlists

Media Info

Resources (Data Access)

Prompts (AI Assistance)

Status

✅ Working: Search, browse, playlists, media info, library stats, watch history, collections, music discovery, resources, prompts

❌ Disabled: Smart playlists (filter logic broken)

🚧 Planned: Remote server browsing

Development

Want to contribute? Point Claude at your local version:

{
  "mcpServers": {
    "plex-dev": {
      "command": "node",
      "args": ["/path/to/plex-mcp/index.js"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400"
      }
    }
  }
}

It works for us. If it doesn't work for you, well we tried. Hit us up, we don't bite. Much.