# lodordev/mcp-tautulli [Health: Active]

**Category:** 📊 Monitoring  
**Repository:** https://github.com/lodordev/mcp-tautulli  
**GitHub Stars:** 7  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/lodordev-mcp-tautulli

## Description
Tautulli (Plex media server monitoring) with 11 read-only tools for activity, history, library stats, user stats, transcode analysis, and resolution breakdowns.

## Tools
Capabilities this server exposes over MCP:

- **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
- **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)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcp-tautulli": {
    "command": "uvx",
    "args": ["mcp-tautulli"],
    "env": {
      "TAUTULLI_URL": "",
      "TAUTULLI_API_KEY": "",
      "TAUTULLI_TLS_VERIFY": ""
    }
  }
}
```

**Requires environment variables:** `TAUTULLI_URL`, `TAUTULLI_API_KEY`, `TAUTULLI_TLS_VERIFY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What lodordev/mcp-tautulli MCP server does

The lodordev/mcp-tautulli MCP server gives MCP clients read-only access to monitoring data collected by Tautulli for a Plex media server. It provides 19 tools covering current playback, historical viewing, library contents, media quality, users, devices, transcoding, and server status.

Search and recently added tools can locate Plex content, while metadata and item statistics provide details for a selected rating key. Library tools report item counts, plays, storage totals, resolutions, codecs, containers, and file sizes. Activity and history tools show who is watching, playback progress, quality, and transcode decisions.

The server does not expose a general Tautulli command passthrough. Each tool invokes a fixed read-oriented Tautulli operation, so it does not modify Tautulli or Plex state. Usernames, IDs, email addresses, thumbnails, and server file paths are omitted from output; client IP addresses are only included when explicitly requested for history.

## How it works

The lodordev/mcp-tautulli MCP server runs as a local stdio process and communicates with an MCP client. It sends requests to a configured Tautulli HTTP or HTTPS endpoint using the configured API key. Tautulli must already be running and connected to Plex.

Several tools can be used together. For example, search or recently added results expose rating keys for metadata and item statistics. Library statistics expose section IDs for library media details. A history record's row ID or an active session's session key can be supplied to the stream-data tool for more detailed bitrate, codec, bandwidth, and transcode information.

Analysis tools include most-watched content, plays by date, day of week, and hour, plus platform, transcode, and source-versus-delivered-resolution breakdowns.

## Setup and configuration

Install Python 3.10 or newer, install the package with `pip install mcp-tautulli` or `uv tool install mcp-tautulli`, and configure the MCP client to start `mcp-tautulli`.

Required environment variables are:

- `TAUTULLI_URL`: The Tautulli base URL, including `http://` or `https://`.
- `TAUTULLI_API_KEY`: The API key from Tautulli's Web Interface settings.

`TAUTULLI_TLS_VERIFY` is optional and defaults to `true`. Set it to `false` when the endpoint uses a self-signed certificate, such as in some reverse-proxy or Tailscale configurations.

The same command and environment configuration can be used in Claude Code's `.mcp.json` or Claude Desktop's configuration file. The server can also be started directly from a shell after exporting the variables.

## Tools and capabilities

The lodordev/mcp-tautulli MCP server includes tools for:

- Current activity, playback history, recently added content, and title search.
- Item metadata, item watch statistics, user statistics, and library statistics.
- Library media-quality details, including file size, resolution, codec, and container.
- Most-watched content and viewing patterns by date, weekday, and hour.
- Server identity, reachability, platform usage, transcoding, stream resolution, and detailed stream performance.

History filters can narrow results by user, media type, search term, or date. Performance details are optional, and IP addresses are disabled by default.

## Limitations and notes

The API key is a full-access Tautulli master key because Tautulli does not provide a read-only API key. The server's read-only behavior comes from its fixed set of retrieval commands, not from restricted credentials.

The lodordev/mcp-tautulli MCP server requires a reachable Tautulli instance and does not replace Tautulli or Plex. If the endpoint cannot be reached, check the URL, firewall, service status, and TLS verification setting. The project is licensed under MIT.

_Full upstream README: https://allmcps.com/mcp/lodordev-mcp-tautulli/readme_