Which integrations are available for this server?

Provides tools for monitoring Plex media server activity, playback history, and statistics through Tautulli, including real-time stream status, library item counts, and per-user watch metrics.

mcp-tautulli

A single-file MCP server for Tautulli — Plex monitoring via Claude Code (or any MCP client).

11 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 fastmcp httpx

Or from the repo:

git clone https://github.com/lodordev/mcp-tautulli.git
cd mcp-tautulli
pip install -r requirements.txt

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_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