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.

• Python 3.10+
• A running Tautulli instance with an API key
• Claude Code (or any MCP-compatible client)

pip install mcp-tautulli

Or from source:

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

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

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

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