Name: MCP Trakt
Author: wwiens

LABSCO SUMMARY

It writes to your Trakt account, not just reads from it.

Most media-catalogue servers stop at lookup. This one checks you in to an episode, adds and removes ratings, edits the watchlist and rewrites watch history with the timestamp you specify — which makes "what should I watch next, and mark the last one done" a single exchange. The list tools also auto-paginate: omit the page argument and you get a flat list up to your limit, with limit=0 fetching everything up to a safety cap of 100.

What it is

An MCP server over the Trakt.tv API that covers both the public catalogue and your personal account. Public data needs nothing but an API client; personal data goes through Trakt's device authorization flow, after which the same conversation can read your history and write to your watchlist, ratings and check-ins.

What you get

Trending, popular, anticipated, favorited, most played and most watched lists for shows and movies, plus last weekend's U.S. box office — fetch_trending_shows, fetch_popular_movies, fetch_anticipated_shows, fetch_boxoffice_movies
Full detail on a title: summary, ratings with their distribution, videos, related titles and cast and crew, with guest stars on request — fetch_show_summary, fetch_movie_summary, fetch_show_ratings, fetch_show_videos, fetch_related_movies, fetch_show_people
Season and episode level detail — episode lists, ratings, engagement stats, cast, trailers, translations by language, who is watching right now, and which lists contain it — fetch_season_info, fetch_season_episodes, fetch_episode_summary, fetch_episode_stats, fetch_season_watching, fetch_episode_translations, fetch_season_lists
People: biography and social links, full movie and show credits with character names and episode counts, and the lists a person appears in — fetch_person_summary, fetch_person_movies, fetch_person_shows, fetch_person_lists
Your account after device authorization: watched shows and movies, ratings you can read, add and remove, and a watchlist you can filter, sort, add to and remove from — fetch_user_watched_shows, fetch_user_ratings, add_user_ratings, remove_user_ratings, fetch_user_watchlist, add_user_watchlist, remove_user_watchlist
Progress through a series: episodes watched against episodes aired, your next episode, per-season breakdown, and the movies and episodes you paused mid-watch — fetch_show_progress, fetch_playback_progress, remove_playback_item
Watch history read and written, with an explicit watched-at timestamp where you want one, and check-ins by show id or by title — fetch_history, add_to_history, remove_from_history, checkin_to_show
Personalised recommendations that skip what you already collected or watchlisted, with a title hidden or restored on request — fetch_movie_recommendations, fetch_show_recommendations, hide_show_recommendation, unhide_movie_recommendation
Community comments on a title, season, episode or single thread, with replies, sorting by likes or replies, and spoilers hidden unless you ask for them — fetch_show_comments, fetch_episode_comments, fetch_comment, fetch_comment_replies
Read-only resource URIs for the popularity lists and your own watched history, such as trakt://shows/trending and trakt://user/watched/movies

Requirements

A Trakt API application, which supplies TRAKT_CLIENT_ID and TRAKT_CLIENT_SECRET; personal data additionally goes through Trakt's device authorization, where you enter a code on the Trakt site once. The package is trakt-mcp (version 0.10.0) and runs straight from the git URL with uvx, from a clone on Python 3.12 or newer, or from ghcr.io/wwiens/trakt_mcpserver — the :latest-stdio image for local clients, :latest for SSE over port 8080. The OAuth token is written to ~/.trakt-mcp/auth_token.json; set TRAKT_AUTH_TOKEN_PATH to move it, which is what the Docker images do so a mounted volume keeps you logged in across container recreations.

Setup effort

One command plus credentials — uvx --from git+https://github.com/wwiens/trakt_mcpserver trakt-mcp, then supply credentials

See installation options

USE CASES

Deciding what to watch tonight

Read what is trending and anticipated, check the rating distribution rather than just the average, and look at related titles to the last thing you enjoyed.

fetch_trending_showsfetch_show_ratingsfetch_related_shows

Picking up a series where you left off

Get your progress on the show — episodes watched against aired, and the next episode to play — then check in once you have watched it.

fetch_show_progresscheckin_to_show

Keeping a watchlist tidy from a chat window

List the watchlist sorted by when you added things, drop the items you have lost interest in, and add the ones you just heard about.

fetch_user_watchlistadd_user_watchlistremove_user_watchlist

Backfilling a history you never logged

Add movies or episodes to your watch history with the date you actually saw them, and remove anything you logged by mistake.

add_to_historyremove_from_historyfetch_history

Reading what people thought without being spoiled

Pull the most-liked comments for a show or a specific episode with spoilers hidden by default, and open the replies on the thread worth following.

fetch_show_commentsfetch_episode_commentsfetch_comment_replies

Researching an actor's filmography

Get the person's biography, then their movie and show credits with character names and episode counts, so a career reads in one pass.

fetch_person_summaryfetch_person_moviesfetch_person_shows

77 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`add_to_history`

Add items to watch history. Marks movies, shows, seasons, or episodes as watched. Optionally specify when they were watched. Requires OAuth authentication.

INSTALLATION

Connect your client

Server setup

Setup

TERMINAL

git clone https://github.com/wwiens/trakt_mcpserver.git
cd trakt_mcpserver
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
cp .env.example .env
python server.py

uvx

TERMINAL

uvx --from git+https://github.com/wwiens/trakt_mcpserver trakt-mcp

MCP Clients

MCPHub

MCPHUB · JSON

{
  "mcpServers": {
    "trakt": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--name",
        "trakt_mcpserver_stdio",
        "-e",
        "TRAKT_CLIENT_ID=<YOUR_TRAKT_CLIENT_ID>",
        "-e",
        "TRAKT_CLIENT_SECRET=<YOUR_TRAKT_CLIENT_SECRET>",
        "-v",
        "trakt_auth:/data",
        "ghcr.io/wwiens/trakt_mcpserver:latest-stdio"
      ]
    }
  }
}

Claude Desktop — local clone

CLAUDE DESKTOP — LOCAL CLONE · JSON

{
  "mcpServers": {
    "trakt": {
      "command": "python",
      "args": [
        "<YOUR_PATH_TO_SERVER>"
      ],
      "env": {
        "TRAKT_CLIENT_ID": "<YOUR_TRAKT_CLIENT_ID>",
        "TRAKT_CLIENT_SECRET": "<YOUR_TRAKT_CLIENT_SECRET>"
      }
    }
  }
}

MCP Trakt

It writes to your Trakt account, not just reads from it.

What it is

What you get

Requirements

Setup effort

Deciding what to watch tonight

Picking up a series where you left off

Keeping a watchlist tidy from a chat window

Backfilling a history you never logged

Reading what people thought without being spoiled

Researching an actor's filmography

77 tools

add_to_history

add_user_ratings

add_user_watchlist

check_auth_status

checkin_to_show

clear_auth

fetch_anticipated_movies

fetch_anticipated_shows

fetch_boxoffice_movies

fetch_comment

fetch_comment_replies

fetch_episode_comments

fetch_episode_lists

fetch_episode_people

fetch_episode_ratings

fetch_episode_stats

fetch_episode_summary

fetch_episode_translations

fetch_episode_videos

fetch_episode_watching

fetch_favorited_movies

fetch_favorited_shows

fetch_history

fetch_movie_comments

fetch_movie_people

fetch_movie_ratings

fetch_movie_recommendations

fetch_movie_summary

fetch_movie_videos

fetch_person_lists

fetch_person_movies

fetch_person_shows

fetch_person_summary

fetch_playback_progress

fetch_played_movies

fetch_played_shows

fetch_popular_movies

fetch_popular_shows

fetch_related_movies

fetch_related_shows

fetch_season_comments

fetch_season_episodes

fetch_season_info

fetch_season_lists

fetch_season_people

fetch_season_ratings

fetch_season_stats

fetch_season_translations

fetch_season_videos

fetch_season_watching

fetch_show_comments

fetch_show_people

fetch_show_progress

fetch_show_ratings

fetch_show_recommendations

fetch_show_seasons

fetch_show_summary

fetch_show_videos

fetch_trending_movies

fetch_trending_shows

fetch_user_ratings

fetch_user_watched_movies

fetch_user_watched_shows

fetch_user_watchlist

fetch_watched_movies

fetch_watched_shows

hide_movie_recommendation

`add_to_history`

`add_user_ratings`

`add_user_watchlist`

`check_auth_status`

`checkin_to_show`

`clear_auth`

`fetch_anticipated_movies`

`fetch_anticipated_shows`

`fetch_boxoffice_movies`

`fetch_comment`

`fetch_comment_replies`

`fetch_episode_comments`

`fetch_episode_lists`

`fetch_episode_people`

`fetch_episode_ratings`

`fetch_episode_stats`

`fetch_episode_summary`

`fetch_episode_translations`

`fetch_episode_videos`

`fetch_episode_watching`

`fetch_favorited_movies`

`fetch_favorited_shows`

`fetch_history`

`fetch_movie_comments`

`fetch_movie_people`

`fetch_movie_ratings`

`fetch_movie_recommendations`

`fetch_movie_summary`

`fetch_movie_videos`

`fetch_person_lists`

`fetch_person_movies`

`fetch_person_shows`

`fetch_person_summary`

`fetch_playback_progress`

`fetch_played_movies`

`fetch_played_shows`

`fetch_popular_movies`

`fetch_popular_shows`

`fetch_related_movies`

`fetch_related_shows`

`fetch_season_comments`

`fetch_season_episodes`

`fetch_season_info`

`fetch_season_lists`

`fetch_season_people`

`fetch_season_ratings`

`fetch_season_stats`

`fetch_season_translations`

`fetch_season_videos`

`fetch_season_watching`

`fetch_show_comments`

`fetch_show_people`

`fetch_show_progress`

`fetch_show_ratings`

`fetch_show_recommendations`

`fetch_show_seasons`

`fetch_show_summary`

`fetch_show_videos`

`fetch_trending_movies`

`fetch_trending_shows`

`fetch_user_ratings`

`fetch_user_watched_movies`

`fetch_user_watched_shows`

`fetch_user_watchlist`

`fetch_watched_movies`

`fetch_watched_shows`

`hide_movie_recommendation`

`hide_show_recommendation`

`remove_from_history`

`remove_playback_item`

`remove_user_ratings`

`remove_user_watchlist`

`search_movies`

`search_shows`

`start_device_auth`

`unhide_movie_recommendation`

`unhide_show_recommendation`