About Plexmcp
Plexmcp is an MCP server published by sandraschi in the RAG category: fastMCP 3.1 MCP server for Plex Media Server — portmanteau tools, optional sampling and agentic workflows, optional RAG, and a glassmorphism webapp.
The repository has 2 stars and 1 forks, with the last commit 7 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/sandraschi/plexmcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Plexmcp
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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).
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.