What can you do with this server?

mcp-tautulli is a read-only MCP server for monitoring and analyzing your Plex media server through Tautulli, offering 15 tools: * Live activity – See who's streaming, what they're watching, playback progress, quality, and bandwidth usage * Playback history – Retrieve recent watch history filtered by user, media type, title, or date * Recently added content – Browse newly added media across Plex libraries * Search content – Find media by title across all libraries * User statistics – Per-user play counts, total watch time, and last-seen info * Library statistics – Item counts, total plays, and last played content per library * Most watched content – Top TV shows, movies, music, or users ranked by plays or watch duration * Server info – Plex server name, version, platform, and connection details * Server status – Verify Tautulli configuration and reachability * Transcode analysis – Direct play vs transcode breakdowns by platform/device * Platform/device stats – Top streaming devices by plays and total watch time * Resolution analysis – Compare source quality vs delivered resolution * Daily play trends – Day-by-day play counts broken down by stream type * Weekly & hourly patterns – Identify peak viewing days and hours All operations are read-only. Configuration requires just a Tautulli URL and API key, and it works with Claude Code or any MCP-compatible client.

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

by lodordev

Overview Schema Related Servers Score Discussions

Python

Remote

mcp-tautulli

A single-file MCP server for Tautulli — 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 instance with an API key
Claude Code (or any MCP-compatible client)

Related MCP server: mcp-server-prometheus

Installation

pip install mcp-tautulli

Or install with uv:

uv tool install mcp-tautulli

Or from source:

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:

{
  "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):

{
  "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:

{
  "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:

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.

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

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

60dResponse time

7wRelease cycle

3Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lodordev/mcp-tautulli'

If you have feedback or need assistance with the MCP directory API, please join our Discord server