MCP server for Trakt — TV show and movie tracking with full sync support.

Website · Documentation

Features

53 tools — complete coverage of the Trakt API: search, metadata, sync, ratings, watchlists, and check-ins.
OAuth via macOS Keychain — credentials stored securely; one-time setup with npx @kud/mcp-trakt setup.
Personalised calendars — see your upcoming episodes and movies, or browse what's airing across all Trakt users.
Full sync support — history, collection, watched state, playback progress, and last-activity timestamps.
Scrobble lifecycle — start, pause, and stop playback tracking so watches are recorded automatically.
Recommendations — personalised movie and show suggestions driven by your viewing history.

Install

1. Create a Trakt application

Create an app at trakt.tv/oauth/applications/new — or manage existing ones at trakt.tv/oauth/applications:

Redirect URI — set it to urn:ietf:wg:oauth:2.0:oob. This server authenticates with Trakt's device flow, which never redirects, but Trakt requires the field; oob is the standard out-of-band placeholder.
Copy the Client ID and Client Secret — you'll paste them in the next step.

2. Authenticate

Run the one-time OAuth setup. It exchanges your credentials for an access token and stores everything in the macOS Keychain (service mcp-trakt):

npx @kud/mcp-trakt@latest setup

Credentials resolution: the server reads from the macOS Keychain by default. On platforms without Keychain (Linux, CI, Docker), set MCP_TRAKT_CLIENT_ID and MCP_TRAKT_ACCESS_TOKEN instead — env vars take precedence over the Keychain.

Then register the server with your MCP client:

claude mcp add trakt npx -- -y @kud/mcp-trakt@latest

Or add it manually to your MCP client config:

{
  "mcpServers": {
    "trakt": {
      "command": "npx",
      "args": ["-y", "@kud/mcp-trakt@latest"]
    }
  }
}

Usage

Once connected, the following tools are available grouped by category.

Search

Tool	Description
`search`	Search for movies, shows, episodes, people, or lists

Movies

Tool	Description
`get_movie`	Get detailed information about a movie
`get_trending_movies`	Movies currently being watched across Trakt
`get_popular_movies`	Most popular movies on Trakt
`get_anticipated_movies`	Most anticipated movies based on watchlist activity
`get_boxoffice_movies`	Top 10 weekend box office movies, updated weekly
`get_movie_ratings`	Community rating distribution for a movie
`get_movie_related`	Movies related to a given movie
`get_movie_people`	Cast and crew for a movie
`get_movie_recommendations`	Personalised movie recommendations

Shows

Tool	Description
`get_show`	Get detailed information about a TV show
`get_trending_shows`	TV shows currently being watched across Trakt
`get_popular_shows`	Most popular TV shows on Trakt
`get_anticipated_shows`	Most anticipated TV shows based on watchlist activity
`get_show_ratings`	Community rating distribution for a TV show
`get_show_seasons`	All seasons for a show, optionally with episode details
`get_show_people`	Cast and crew for a TV show
`get_show_related`	TV shows related to a given show
`get_show_recommendations`	Personalised TV show recommendations

Episodes

Tool	Description
`get_season_episodes`	All episodes in a specific season
`get_episode`	Full details for a specific episode

People

Tool	Description
`get_person`	Details about a person (actor, director, etc.)
`get_person_credits`	Movie or show credits for a person

Calendar

Tool	Description
`get_my_show_calendar`	Upcoming episodes based on shows you watch
`get_my_movie_calendar`	Upcoming movies based on your watchlist
`get_all_show_calendar`	All shows airing across all Trakt users
`get_all_movie_calendar`	All movies releasing across all Trakt users

History

Tool	Description
`get_history`	Watch history for the authenticated user
`add_to_history`	Mark movies or episodes as watched
`remove_from_history`	Remove items from watch history

Collection

Tool	Description
`get_collection_movies`	All movies in your collection
`get_collection_shows`	All shows in your collection
`add_to_collection`	Add movies, shows, or episodes to your collection
`remove_from_collection`	Remove items from your collection

Watched

Tool	Description
`get_watched_movies`	All movies you have watched with play counts
`get_watched_shows`	All shows you have watched with play counts per episode

Playback

Tool	Description
`get_playback`	Paused playback progress to resume later
`delete_playback`	Delete a paused playback entry

Sync

Tool	Description
`get_sync_last_activities`	Timestamps for when each resource was last updated

Ratings

Tool	Description
`get_ratings`	Ratings you have given, filterable by type and value
`add_rating`	Rate movies, shows, seasons, or episodes (1–10)
`remove_rating`	Remove ratings from movies, shows, or episodes

Watchlist

Tool	Description
`get_watchlist`	Your watchlist, filterable by type and sort order
`add_to_watchlist`	Add movies, shows, or episodes to your watchlist
`remove_from_watchlist`	Remove items from your watchlist

Check-in

Tool	Description
`checkin`	Check in to a movie or episode you are watching right now
`delete_checkin`	Cancel the current active check-in

Scrobble

Tool	Description
`scrobble_start`	Start scrobbling when playback begins
`scrobble_pause`	Pause scrobbling when playback is paused
`scrobble_stop`	Stop scrobbling when playback ends to record the watch

User

Tool	Description
`get_user_profile`	Profile information for any Trakt user
`get_user_stats`	Watch statistics for a user
`get_user_watching`	What a user is currently watching

Development

git clone https://github.com/kud/mcp-trakt.git
cd mcp-trakt
npm install
npm run dev          # run directly with tsx, no build needed
npm run inspect:dev  # open the MCP Inspector against live tsx
npm run build        # compile TypeScript to dist/
npm run typecheck    # type-check without emitting
npm test             # run the test suite

📚 Full documentation → mcp-trakt/docs

MCP Trakt

README