About lodordev/mcp-tautulli
lodordev/mcp-tautulli is an MCP server in the Blockchain category: only tools for activity, history, library stats, user stats, transcode analysis, and resolution breakdowns.
Install
git clone https://github.com/lodordev/mcp-tautulliThis 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.
Tools (19)
tautulli_activityCurrent Plex streaming activity — who's watching what, progress, quality
Parameters not published.
tautulli_historyRecent 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`
Parameters not published.
tautulli_item_statsWatch stats for one item — plays/time over 24h/7d/30d/all, plus which users watched it (friendly name only)
Parameters not published.
tautulli_library_media_infoPer-library media-quality breakdown — total size, item count, and per-item resolution/codec/container/size (find largest files)
Parameters not published.
tautulli_library_statsLibrary item counts, total plays, last played per library — output includes `[id: N]` section ids
Parameters not published.
tautulli_metadataFull 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
Parameters not published.
tautulli_most_watchedTop content by plays or duration (TV, movies, music, users)
Parameters not published.
tautulli_platform_statsTop platforms/devices by plays and watch time
Parameters not published.
tautulli_plays_by_dateDaily play counts over time by stream type
Parameters not published.
tautulli_plays_by_day_of_weekWeekly viewing patterns — which days see the most activity
Parameters not published.
Show all 19 tools
tautulli_plays_by_hourHourly viewing distribution — when people watch
Parameters not published.
tautulli_recently_addedRecently added content — what's new in your Plex libraries
Parameters not published.
tautulli_searchSearch Plex content by title across all libraries — output includes `[key: N]` rating keys
Parameters not published.
tautulli_server_infoPlex server identity — name, version, platform, connection
Parameters not published.
tautulli_statusServer config and reachability check
Parameters not published.
tautulli_stream_dataDetailed stream performance data — bitrate, codec, transcode decision, bandwidth for a specific play (use `row_id` from history or `session_key` from activity)
Parameters not published.
tautulli_stream_resolutionSource vs delivered resolution analysis
Parameters not published.
tautulli_transcode_statsDirect play vs transcode breakdown by platform
Parameters not published.
tautulli_user_statsPer-user watch statistics — plays, watch time, last seen
Parameters not published.
Ask AI
Ask AI about lodordev/mcp-tautulli
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
mcp-tautulli
A single-file MCP server for Tautulli — Plex monitoring via Claude Code (or any MCP client).
15 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
pip install mcp-tautulli
Or from source:
git clone https://github.com/lodordev/mcp-tautulli.git
cd mcp-tautulli
pip install .
Configuration
Three environment variables:
| Variable | Required | Default | Description |
|---|---|---|---|
TAUTULLI_URL |
Yes | — | Tautulli base URL (e.g. http://localhost: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:
{
"mcpServers": {
"tautulli": {
"command": "python",
"args": ["/path/to/tautulli.py"],
"env": {
"TAUTULLI_URL": "http://your-tautulli-host:8181",
"TAUTULLI_API_KEY": "your-api-key-here"
}
}
}
}
Or run standalone:
export TAUTULLI_URL="http://localhost:8181"
export TAUTULLI_API_KEY="your-api-key"
python tautulli.py
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) |
tautulli_recently_added |
Recently added content — what's new in your Plex libraries |
tautulli_search |
Search Plex content by title across all libraries |
tautulli_user_stats |
Per-user watch statistics — plays, watch time, last seen |
tautulli_library_stats |
Library item counts, total plays, last played per library |
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 |
tautulli_stream_resolution |
Source vs delivered resolution analysis |
tautulli_plays_by_date |
Daily play counts over time by stream type |
tautulli_plays_by_day_of_week |
Weekly viewing patterns — which days see the most activity |
tautulli_plays_by_hour |
Hourly viewing distribution — when people watch |
All tools are read-only — this server does not modify any Tautulli or Plex state.
tautulli_activity
2 active stream(s):
• Alice playing "The Bear S02E06 — Fishes" — 45%, on Apple TV (direct play)
• Bob playing "Oppenheimer (2023)" — 12%, on Roku (transcode)
Bandwidth: 18.5 Mbps total (LAN: 12.2, WAN: 6.3)
tautulli_plays_by_day_of_week
Plays by day of week (last 30 days):
Monday : 91 ██████████████████████████████ (TV:62, Movies:18, Music:11) ← peak
Tuesday : 76 █████████████████████████ (TV:56, Movies:15, Music:5)
Wednesday: 62 ████████████████████ (TV:34, Movies:20, Music:8)
Thursday : 45 ██████████████ (TV:32, Movies:8, Music:5)
Friday : 59 ███████████████████ (TV:37, Movies:14, Music:8)
Saturday : 50 ████████████████ (TV:32, Movies:10, Music:8)
Sunday : 86 ████████████████████████████ (TV:60, Movies:16, Music:10)
Total: 469 plays, avg 67.0/day
tautulli_search
Search results for "breaking":
Movies:
• Breaking (2012) — Movies
TV Shows:
• Breaking Bad (2008) — TV Shows
Troubleshooting
"TAUTULLI_URL environment variable not set"
Both TAUTULLI_URL and TAUTULLI_API_KEY must be set. Find your API key in Tautulli → Settings → Web Interface → API Key.
TLS/SSL errors
If Tautulli is behind a reverse proxy with a self-signed certificate, set TAUTULLI_TLS_VERIFY=false.
"Tautulli unreachable" Verify the URL is accessible from the machine running the MCP server. Check firewalls and that Tautulli is running.
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.