# Mcp Tautulli > MCP server for Tautulli — Plex monitoring via Claude Code - **Type:** MCP server - **Install:** `agentstack add mcp-lodordev-mcp-tautulli` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [lodordev](https://agentstack.voostack.com/s/lodordev) - **Installs:** 0 - **Category:** [Integrations](https://agentstack.voostack.com/c/integrations) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [lodordev](https://github.com/lodordev) - **Source:** https://github.com/lodordev/mcp-tautulli ## Install ```sh agentstack add mcp-lodordev-mcp-tautulli ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # mcp-tautulli A single-file [MCP](https://modelcontextprotocol.io/) server for [Tautulli](https://tautulli.com/) — Plex monitoring via Claude Code (or any MCP client). 16 read-only tools. No mutations. All configuration via environment variables. ## Prerequisites - Python 3.10+ - A running [Tautulli](https://tautulli.com/) instance with an API key - [Claude Code](https://claude.ai/code) (or any MCP-compatible client) ## Installation ```bash pip install mcp-tautulli ``` Or install with uv: ```bash uv tool install mcp-tautulli ``` Or from source: ```bash 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 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`: ```jsonc { "mcpServers": { "tautulli": { "command": "mcp-tautulli", "env": { // Include the protocol (http:// or https://) "TAUTULLI_URL": "http://your-tautulli-host:8181", "TAUTULLI_API_KEY": "your-api-key-here" } } } } ``` ## Claude Desktop Setup Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows): ```json { "mcpServers": { "tautulli": { "command": "mcp-tautulli", "env": { "TAUTULLI_URL": "http://your-tautulli-host:8181", "TAUTULLI_API_KEY": "your-api-key-here" } } } } ``` ## 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: ```json { "mcpServers": { "tautulli-dev": { "command": "uv", "args": ["run", "--directory", "/path/to/mcp-tautulli", "mcp-tautulli"], "env": { "TAUTULLI_URL": "http://your-tautulli-host:8181", "TAUTULLI_API_KEY": "your-api-key-here" } } } } ``` 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: ```bash export TAUTULLI_URL="http://localhost:8181" export TAUTULLI_API_KEY="your-api-key" mcp-tautulli ``` ## 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 | | `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 | | `tautulli_stream_data` | Detailed stream performance data — bitrate, codec, transcode decision, bandwidth for a specific play (use `row_id` from history or `session_key` from activity) | All tools are **read-only** — this server does not modify any Tautulli or Plex state. Example Output **`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_stream_data`** (pass `row_id` from history output) ``` Stream Performance Data: Media: Game of Thrones (episode) Quality Profile: Original (20 Mbps 1080p) Overall Bitrate: 19842 kbps Video Bitrate: 18900 kbps Audio Bitrate: 640 kbps Stream Resolution: 1080p Stream Video Codec: h264 Stream Framerate: 24p Stream Audio Codec: ac3 Stream Audio Channels: 6 Original Container: mkv Original Video Codec: h264 Original Audio Codec: ac3 Video Decision: direct play Audio Decision: direct play Bandwidth: 19842 kbps Location: lan ``` **`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 ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [lodordev](https://github.com/lodordev) - **Source:** [lodordev/mcp-tautulli](https://github.com/lodordev/mcp-tautulli) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-lodordev-mcp-tautulli - Seller: https://agentstack.voostack.com/s/lodordev - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.