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

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

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

security – no known vulnerabilities

license - permissive license

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Tools

View all tools

Latest Blog Posts

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
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

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