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.
Run the one-time OAuth setup to store your Trakt credentials in the macOS Keychain:
npx @kud/mcp-trakt@latest setup 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" ] } } } Once connected, the following tools are available grouped by category.
Tool Description searchSearch for movies, shows, episodes, people, or lists
Tool Description get_movieGet detailed information about a movie get_trending_moviesMovies currently being watched across Trakt get_popular_moviesMost popular movies on Trakt get_anticipated_moviesMost anticipated movies based on watchlist activity get_boxoffice_moviesTop 10 weekend box office movies, updated weekly get_movie_ratingsCommunity rating distribution for a movie get_movie_relatedMovies related to a given movie get_movie_peopleCast and crew for a movie get_movie_recommendationsPersonalised movie recommendations
Tool Description get_showGet detailed information about a TV show get_trending_showsTV shows currently being watched across Trakt get_popular_showsMost popular TV shows on Trakt get_anticipated_showsMost anticipated TV shows based on watchlist activity get_show_ratingsCommunity rating distribution for a TV show get_show_seasonsAll seasons for a show, optionally with episode details get_show_peopleCast and crew for a TV show get_show_relatedTV shows related to a given show get_show_recommendationsPersonalised TV show recommendations
Tool Description get_season_episodesAll episodes in a specific season get_episodeFull details for a specific episode
Tool Description get_personDetails about a person (actor, director, etc.) get_person_creditsMovie or show credits for a person
Tool Description get_my_show_calendarUpcoming episodes based on shows you watch get_my_movie_calendarUpcoming movies based on your watchlist get_all_show_calendarAll shows airing across all Trakt users get_all_movie_calendarAll movies releasing across all Trakt users
Tool Description get_historyWatch history for the authenticated user add_to_historyMark movies or episodes as watched remove_from_historyRemove items from watch history
Tool Description get_collection_moviesAll movies in your collection get_collection_showsAll shows in your collection add_to_collectionAdd movies, shows, or episodes to your collection remove_from_collectionRemove items from your collection
Tool Description get_watched_moviesAll movies you have watched with play counts get_watched_showsAll shows you have watched with play counts per episode
Tool Description get_playbackPaused playback progress to resume later delete_playbackDelete a paused playback entry
Tool Description get_sync_last_activitiesTimestamps for when each resource was last updated
Tool Description get_ratingsRatings you have given, filterable by type and value add_ratingRate movies, shows, seasons, or episodes (1–10) remove_ratingRemove ratings from movies, shows, or episodes
Tool Description get_watchlistYour watchlist, filterable by type and sort order add_to_watchlistAdd movies, shows, or episodes to your watchlist remove_from_watchlistRemove items from your watchlist
Tool Description checkinCheck in to a movie or episode you are watching right now delete_checkinCancel the current active check-in
Tool Description scrobble_startStart scrobbling when playback begins scrobble_pausePause scrobbling when playback is paused scrobble_stopStop scrobbling when playback ends to record the watch
Tool Description get_user_profileProfile information for any Trakt user get_user_statsWatch statistics for a user get_user_watchingWhat a user is currently watching
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