lodordev/mcp-tautulli

A single-file MCP server for Tautulli — Plex monitoring via Claude Code (or any MCP client).
19 read-only tools. No mutations. All configuration via environment variables.
Prerequisites
- Python 3.10+
- A running Tautulli instance with an API key
- Claude Code (or any MCP-compatible client)
Installation
Or install with uv:
Or from source:
Configuration
Three environment variables:
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| TAUTULLI_URL | Yes | — | Tautulli base URL with protocol (e.g. http://localhost:8181 or https://tautulli.example.com:8181) |
| TAUTULLI_API_KEY | Yes | — | Tautulli API key (Settings → Web Interface → API Key) |
| TAUTULLI_TLS_VERIFY | No | true | Set to false if using self-signed certs (e.g. Tailscale serve) |
Claude Code Setup
Add to your project's .mcp.json:
Claude Desktop Setup
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Local Development Config
To point your MCP client at local source without reinstalling after every change, use uv run --directory instead of the installed binary:
This works in both Claude Code (.mcp.json) and Claude Desktop (claude_desktop_config.json). Restart the client after code changes — no uv tool install needed.
Or run standalone:
Tools
| Tool | Description |
|------|-------------|
| tautulli_activity | Current Plex streaming activity — who's watching what, progress, quality |
| tautulli_history | Recent playback history with filters (user, media type, search, date) — includes transcode decision; pass include_ip=true to show client IP (off by default, it's PII) and include_performance=true to also fetch per-record bitrate via get_stream_data |
| tautulli_recently_added | Recently added content — what's new in your Plex libraries |
| tautulli_search | Search Plex content by title across all libraries — output includes [key: N] rating keys |
| tautulli_metadata | Full metadata for one item by rating key — summary, cast/crew, genres, ratings, and media quality (resolution, codecs, HDR/Dolby Vision, file size). Server file paths omitted |
| tautulli_item_stats | Watch stats for one item — plays/time over 24h/7d/30d/all, plus which users watched it (friendly name only) |
| tautulli_user_stats | Per-user watch statistics — plays, watch time, last seen |
| tautulli_library_stats | Library item counts, total plays, last played per library — output includes [id: N] section ids |
| tautulli_library_media_info | Per-library media-quality breakdown — total size, item count, and per-item resolution/codec/container/size (find largest files) |
| tautulli_most_watched | Top content by plays or duration (TV, movies, music, users) |
| tautulli_server_info | Plex server identity — name, version, platform, connection |
| tautulli_status | Server config and reachability check |
| tautulli_transcode_stats | Direct play vs transcode breakdown by platform |
| tautulli_platform_stats | Top platforms/devices by plays and watch time |