MCP cover image
See in Github
2025-04-10

Plex MCP server

1

Github Watches

1

Github Forks

0

Github Stars

Plex MCP Server

This is a Python-based MCP server that integrates with the Plex Media Server API to search for movies and manage playlists. It uses the PlexAPI library for seamless interaction with your Plex server.

Setup

Prerequisites

  • Python 3.8 or higher
  • uv package manager
  • A Plex Media Server with API access

Installation

  1. Clone this repository:

    git clone <repository-url>
    cd plex-mcp
    
  2. Install dependencies with uv:

    uv venv
    source .venv/bin/activate
    uv sync
    
  3. Configure environment variables for your Plex server:

Finding Your Plex Token

You can find your Plex token in this way:

  • Sign in to Plex Web App
  • Open Developer Tools
  • In Console tab, paste and run:
    window.localStorage.getItem('myPlexAccessToken')
    

Usage with Claude

Add the following configuration to your Claude app:

{
    "mcpServers": {
        "plex": {
            "command": "uv",
            "args": [
                "--directory",
                "FULL_PATH_TO_PROJECT/plex-mcp",
                "run",
                "plex-mcp.py"
            ],
            "env": {
                "PLEX_TOKEN": "YOUR_PLEX_TOKEN",
                "PLEX_SERVER_URL": "YOUR_PLEX_SERVER_URL"
            }
        }
    }
}

Available Commands

The Plex MCP server exposes these commands:

Command Description OpenAPI Reference
search_movies Search for movies in your library by title /library/sections/{sectionKey}/search
get_movie_details Get detailed information about a specific movie /library/metadata/{ratingKey}
get_movie_genres Get the genres for a specific movie /library/sections/{sectionKey}/genre
list_playlists List all playlists on your Plex server /playlists
get_playlist_items Get the items in a specific playlist /playlists/{playlistID}/items
create_playlist Create a new playlist with specified movies /playlists
delete_playlist Delete a playlist from your Plex server /playlists/{playlistID}
add_to_playlist Add a movie to an existing playlist /playlists/{playlistID}/items
recent_movies Get recently added movies from your library /library/recentlyAdded

Testing

The repository includes a test script to verify connectivity and functionality:

  • simple-direct-plex-test.py - A direct PlexAPI test that doesn't use the MCP server

Troubleshooting

If you encounter connection issues, try these steps:

  1. Verify your environment variables are set correctly:

    echo $PLEX_SERVER_URL
    echo $PLEX_TOKEN
    
  2. Test direct connectivity to your Plex server:

    python simple-direct-plex-test.py
    

相关推荐

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • Lists Tailwind CSS classes in monospaced font

  • https://appia.in
  • Siri Shortcut Finder – your go-to place for discovering amazing Siri Shortcuts with ease

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • modelcontextprotocol
  • Model Context Protocol Servers

  • Mintplex-Labs
  • The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

  • ravitemer
  • A powerful Neovim plugin for managing MCP (Model Context Protocol) servers

  • jae-jae
  • MCP server for fetch web page content using Playwright headless browser.

  • patruff
  • Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

  • pontusab
  • The Cursor & Windsurf community, find rules and MCPs

  • n8n-io
  • Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

    Reviews

    4 (1)
    Avatar
    user_c3YQlpIn
    2025-04-18

    I have been using plex-mcp, developed by djbriane, and it has greatly enhanced my experience with Plex. The seamless integration and user-friendly interface make it easy to manage my media content. With the comprehensive documentation provided, setup was a breeze. Highly recommend checking it out: https://github.com/djbriane/plex-mcp.