Plexmcp
FastMCP 3.1 MCP server for Plex Media Server — portmanteau tools, optional sampling and agentic workflows, optional RAG, and a glassmorphism webapp
Ask AI about Plexmcp
Powered by Claude · Grounded in docs
I know everything about Plexmcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
PlexMCP
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.
Quick start · Install · Web app · All docs · Changelog
Why PlexMCP?
| You want… | PlexMCP gives you… |
|---|---|
| Agents that “see” your Plex | MCP tools for libraries, media, search, playlists, playback helpers, server health |
| Semantic search over your titles | Optional RAG (plex_rag) when vector dependencies are configured |
| A real UI | FastAPI + Next.js web app — libraries, movies, keyword + semantic search, chat, settings |
| One server, many clients | stdio for Claude / Cursor; HTTP + /mcp when using the bundled backend |
Quick start (MCP over stdio)
git clone https://github.com/sandraschi/plex-mcp.git
cd plex-mcp
uv sync
$env:PLEX_TOKEN = "your-x-plex-token"
$env:PLEX_URL = "http://127.0.0.1:32400"
uv run plex-mcp-advanced
Point your MCP client at that process. Even shorter path → docs/QUICKSTART.md. Tokens, URLs, and clients → docs/INSTALL.md.
Browser UI → docs/WEBAPP.md (ports 10740 / 10741).
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/INSTALL.md | uv, clone, run, Claude Desktop |
| 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/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 | Wikipedia-style enrichment |
| 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 (at a glance)
Python 3.12+ · FastMCP 3.2 · plexapi · optional LanceDB RAG (see docs/RAG.md for PYTHONPATH notes) · web app FastAPI + Next.js
License & credits
MIT — LICENSE.
Plex, FastMCP, and contributors.
Fleet standards cross-link: mcp-central-docs (e.g. SOTA requirements).