Command Palette

Search for a command to run...

UnylyUnyly
Browse all

PlexMCP

FreeNot checked

An MCP server for Plex Media Server that enables natural language interaction with your media library, including search, browse, and chat features via an option

GitHubEmbed

About

An MCP server for Plex Media Server that enables natural language interaction with your media library, including search, browse, and chat features via an optional web app.

README

PlexMCP

Just Ruff Python Biome FastMCP

Talk to your library. An open Model Context Protocol server for Plex Media Server — plus an optional glass-style web app for browsing, search, and chat.

CI Python 3.12+ FastMCP License: MIT Ruff Latest release

Quick start · Install · Web app · All docs · Changelog


Quick Start

Download Plex MCP_*_x64-setup.exe from Releases → double-click → launch Plex MCP. Install guide.

Claude Desktop only (no installer) — latest .mcpb bundle + registration script:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/sandraschi/plexmcp/releases/latest/download/install.ps1 | iex"

Developers from source:

git clone https://github.com/sandraschi/plexmcp plex-mcp
cd plex-mcp
just install
just webapp

Documentation map

Read this… When you care about…
docs/README.md Hub — every guide in one place
docs/QUICKSTART.md ~60s — MCP only, web UI, RAG pointer
docs/ONBOARDING.md First run — connect Plex, costs, pitfalls, sanity check
docs/INSTALL.md Tauri desktop (primary), uv, clone, MCPB, Claude Desktop
docs/TAURI.md Maintainer: build installer, production pitfalls
docs/DOCUMENTATION_INDEX.md Full doc map + archival paths
docs/PLEX.md What Plex is, tokens, remote access (plain language)
docs/ARCHITECTURE.md How the MCP server, backend, and UI fit together
docs/SELF_HOSTING.md Home lab: HTTPS, reverse proxy, secrets, hardening
docs/DOCKER.md Optional Docker Compose example
docs/CONFIGURATION.md Environment variables, sampling, RAG, *arr
docs/LIBRARY_BUILDING.md Build a library: folders, naming, agents, ripping legality, rtorrent-mcp handoff
docs/COLLECTORS_TOOLKIT.md Scene naming, verification, Plex realities, self-audit, lawful links
docs/BITTORRENT_GUIDE.md Protocol, lawful uses, rtorrent-mcp setup, sourcing-question policy
docs/TOOLS.md Tool surface (portmanteaus and what they do)
docs/WEBAPP.md Web app ports, startup, feature pointers
docs/RAG.md Semantic search and indexing
docs/ENRICHMENT.md Deep per-item enrichment: Wikipedia + TMDB + JustWatch, LLM dossiers, cross-references
docs/TROUBLESHOOTING.md Auth, connection, RAG, common errors
docs/DEVELOPMENT.md Tests, lint, layout for contributors
docs/PRD.md Product scope and constraints
docs/plans/OPERATIONAL_IMPROVEMENTS.md Phased doc/DX/ops todo (checklist)
docs/plans/ROADMAP.md Feature specs and product roadmap

Stack

MCP server: Python 3.12+ · FastMCP 3.4+ · plexapi · Pydantic 2

Webapp backend: FastAPI · Uvicorn — calls the same Python package as the MCP server in-process, so behavior always matches

Webapp frontend: Next.js 15 · React 18 · TypeScript · Tailwind CSS · lucide-react icons

Search: LanceDB + fastembed for optional semantic/RAG search over your library metadata (see docs/RAG.md for PYTHONPATH notes)

Desktop app: Tauri 2 (Rust) — see docs/TAURI.md

Not currently used: Zustand, Framer Motion (webapp state is local useState/useEffect; no client-side animation library beyond CSS transitions).


License & credits

MIT — LICENSE. Plex, FastMCP, and contributors.

Fleet standards cross-link: mcp-central-docs (e.g. SOTA requirements).

from github.com/sandraschi/plexmcp

Installing PlexMCP

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/sandraschi/plexmcp

FAQ

Is PlexMCP MCP free?

Yes, PlexMCP MCP is free — one-click install via Unyly at no cost.

Does PlexMCP need an API key?

No, PlexMCP runs without API keys or environment variables.

Is PlexMCP hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install PlexMCP in Claude Desktop, Claude Code or Cursor?

Open PlexMCP on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare PlexMCP with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All communication MCPs