Home Automation & IoT · Entertainment & Media

Plex MCP Server

niavasha/plex-mcp-server

A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to your Plex Media Server, Sonarr, Radarr, and Trakt.tv — all from a single unified server.

Install

npx plex-mcp-server

Client configuration

{
  "mcpServers": {
    "plex": {
      "command": "node",
      "args": [
        "/path/to/plex-mcp-server/build/plex-mcp-server.js"
      ],
      "env": {
        "PLEX_URL": "<PLEX_URL>",
        "PLEX_TOKEN": "<PLEX_TOKEN>",
        "SONARR_URL": "<SONARR_URL>",
        "SONARR_API_KEY": "<SONARR_API_KEY>",
        "RADARR_URL": "<RADARR_URL>",
        "RADARR_API_KEY": "<RADARR_API_KEY>",
        "TRAKT_CLIENT_ID": "<TRAKT_CLIENT_ID>",
        "TRAKT_CLIENT_SECRET": "<TRAKT_CLIENT_SECRET>"
      }
    }
  }
}

Environment variables

PLEX_URLPLEX_TOKENSONARR_URLSONARR_API_KEYRADARR_URLRADARR_API_KEYTRAKT_CLIENT_IDTRAKT_CLIENT_SECRET
Author
@niavasha
Category
Home Automation & IoT, Entertainment & Media
License
MIT
Updated
Oct 6, 2026

About Plex MCP Server

This MCP server transforms your Plex Media Server into an AI-queryable database. Ask your AI assistant questions like:

Features

  • Plex Library Management — Browse libraries, search media, get detailed metadata, list playlists and watchlist

  • Tautulli-Style Analytics — Viewing statistics, user activity, popular content, watch history

  • Personalized Recommendations — AI-powered movie suggestions based on your watch history, genres, directors, and actors. Supports per-user profiles for multi-user Plex servers.

  • Sonarr/Radarr Integration — Browse, search, add series/movies, view queues, trigger downloads

  • Trakt.tv Sync — OAuth authentication, watch history sync, enhanced statistics, scrobbling. When configured, Trakt data enriches recommendations by catching movies watched outside Plex.

  • Write Operations (opt-in) — Create/edit playlists, update metadata, manage watchlist, rate media, and mark media watched or unwatched

Tools (40)

  • get_libraries

    List all Plex libraries

  • get_library_items

    List items in a library with pagination

  • export_library

    Export a full library to JSON (under./exports)

  • search_media

    Search media globally or within one library

  • get_recently_added

    Recently added content

  • get_on_deck

    Continue watching list

  • get_media_details

    Detailed media info

  • get_editable_fields

    Show editable fields and available tags for an item

  • get_playlists

    List all Plex playlists

  • get_playlist_items

    List items in a playlist

  • get_watchlist

    Get the current account Watchlist from Plex Discover

  • get_recently_watched

    Recently watched content

  • get_watch_history

    Detailed watch sessions

  • get_fully_watched

    Fully watched movies/shows

  • get_watch_stats

    Comprehensive viewing statistics

  • get_user_stats

    User activity statistics

  • get_library_stats

    Library usage metrics

  • get_popular_content

    Most popular content analysis

  • get_recommendations

    Personalized movie recommendations based on your watch history

  • get_active_sessions

    Currently active Plex streams — who is watching what, player state, transcoding

  • update_metadata

    Update metadata fields and editable tags for a media item

  • update_metadata_from_json

    Apply a metadata JSON payload using best-effort field mapping

  • create_playlist

    Create a new smart or static playlist

  • add_to_playlist

    Add a media item to a playlist

  • remove_from_playlist

    Remove an item from a playlist

  • clear_playlist

    Preview and optionally clear all items from a playlist (confirm=true)

  • delete_playlist

    Delete a playlist without deleting the underlying media

  • add_to_watchlist

    Add a matched local movie or show to the account Watchlist

  • remove_from_watchlist

    Remove an account Watchlist item by its global Plex GUID or local rating key

  • rate_media

    Set the user's rating for a media item from 0 to 10

  • mark_watched

    Mark a media item as watched

  • mark_unwatched

    Mark a media item as unwatched

  • sonarr_get_series

    List series with optional title filter

  • sonarr_search

    Search TheTVDB for new series

  • sonarr_add_series

    Add series by TVDB ID

  • sonarr_get_missing

    Missing/wanted episodes

  • sonarr_get_queue

    Download queue

  • sonarr_get_calendar

    Upcoming episodes

  • sonarr_get_profiles

    Quality profiles and root folders

  • sonarr_trigger_search

    Trigger missing episode search

Details on this page are taken from the project's README. Open README

Supported clients

Clients mentioned in this server's README:

View all
Claude Desktop logo

Claude Desktop

Desktop · Freemium · Proprietary

Anthropic's official Claude AI desktop application. Supports MCP servers to extend functionality.

WindowsMacOS
VS Code GitHub Copilot logo

VS Code GitHub Copilot

Desktop · Freemium · MIT

VS Code integrates MCP with GitHub Copilot through agent mode, allowing direct interaction with MCP-provided tools in your agentic coding workflow. Configure servers in Claude Desktop, workspace, or user settings, with guided MCP installation and secure handling of secrets in input variables to avoid leaking hardcoded keys.

WindowsMacOSLinuxWeb

Related MCP servers

More servers
rulego logo

rulego

rulego/rulego

1.1k

RuleGo also provides a large number of reusable components that support the aggregation, filtering, distribution, transformation, enrichment, and execution of various actions on data, and can also interact and integrate with various protocols and systems.

Home Automation & IoT
Homeassistant MCP logo

Homeassistant MCP

tevonsb/homeassistant-mcp

246

A powerful bridge between your Home Assistant instance and Language Learning Models (LLMs), enabling natural language control and monitoring of your smart home devices through the Model Context Protocol (MCP). This server provides a comprehensive API for managing your entire Home Assistant ecosystem, from device control to system administration.

Home Automation & IoT
MCP Server Apple Shortcuts logo

MCP Server Apple Shortcuts

recursechat/mcp-server-apple-shortcuts

145

A Model Context Protocol (MCP) server that lets AI assistants like Claude control Apple Shortcuts automations. This enables AI models to trigger shortcuts and automate tasks on macOS in a safe and controlled way.

Home Automation & IoT
Siri Shortcuts logo

Siri Shortcuts

dvcrn/mcp-server-siri-shortcuts

115

This MCP server provides access to Siri shortcuts functionality via the Model Context Protocol (MCP). It allows listing, opening, and running shortcuts from the macOS Shortcuts app.

Home Automation & IoT
Hass MCP logo

Hass MCP

voska/hass-mcp

60

A Model Context Protocol (MCP) server for Home Assistant integration with Claude and other LLMs.

Home Automation & IoT
MCP Server Home Assistant logo

MCP Server Home Assistant

allenporter/mcp-server-home-assistant

45

A Model Context Protocol Server for Home Assistant. See Model Context Protocol for context.

Home Automation & IoT