<div align="center">

PlexMCP

<p align="center"> <a href="https://github.com/casey/just"><img src="https://img.shields.io/badge/just-ready_to_go-7c5cfc?style=flat-square&logo=just&logoColor=white" alt="Just"></a> <a href="https://github.com/astral-sh/ruff"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json" alt="Ruff"></a> <a href="https://python.org"><img src="https://img.shields.io/badge/Python-3.13+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python"></a> <a href="https://biomejs.dev"><img src="https://img.shields.io/badge/Linted_with-Biome-60a5fa?style=flat-square&logo=biome&logoColor=white" alt="Biome"></a> <a href="https://github.com/PrefectHQ/fastmcp"><img src="https://img.shields.io/badge/FastMCP-3.2-7c5cfc?style=flat-square" alt="FastMCP"></a> </p>

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

</div>

---

Quick Start

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

Developers from source:

git clone https://github.com/sandraschi/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/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/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).