MCP Tautulli

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.