How do I install the Trakt Tv skill?

Run npx skillmds@latest add diegosouzapw/trakt-tv in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Trakt Tv safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Trakt Tv?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Trakt Tv free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Trakt Tv?

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Trakt Tv by diegosouzapw — Agent Skill

Name: Trakt Tv
Rating: 4.2 (5 reviews)
Author: diegosouzapw

Trakt Tv

Trakt.tv integration for tracking movies and TV shows. Use when syncing watch history, checking what user is watching, updating watchlists, or integrating Trakt data into memory. Triggers on "trakt", "watch history", "what am I watching", "TV shows", "movies watched".

diegosouzapw Updated Sep 8, 2026 54 repo stars

File contents

Trakt.tv Skill

Sync and track movies/TV shows via Trakt.tv API.

Setup

Required environment variables:

TRAKT_CLIENT_ID: Get from https://trakt.tv/oauth/applications (create app, use Client ID)
TRAKT_USERNAME: Your Trakt username (profile must be public, or use OAuth for private)

API Endpoints

Base URL: https://api.trakt.tv

Headers required:

Content-Type: application/json
trakt-api-version: 2
trakt-api-key: {TRAKT_CLIENT_ID}

Common Operations

Get Watch History

curl -s "https://api.trakt.tv/users/{username}/history?limit=10" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Currently Watching

curl -s "https://api.trakt.tv/users/{username}/watching" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Watchlist

curl -s "https://api.trakt.tv/users/{username}/watchlist" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Watched Shows (with progress)

curl -s "https://api.trakt.tv/users/{username}/watched/shows" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Watched Movies

curl -s "https://api.trakt.tv/users/{username}/watched/movies" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Ratings

curl -s "https://api.trakt.tv/users/{username}/ratings" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Get Stats

curl -s "https://api.trakt.tv/users/{username}/stats" \
  -H "Content-Type: application/json" \
  -H "trakt-api-version: 2" \
  -H "trakt-api-key: $TRAKT_CLIENT_ID"

Memory Integration

When syncing to memory, create/update a file like entertainment.md:

# Entertainment

## Currently Watching
- **Show Name** - Season X, Episode Y (last watched: DATE)

## Recently Watched
- Movie Name (DATE) - ⭐ RATING/10

## Watchlist
- Show/Movie to watch

## Stats
- Total shows: X
- Total movies: Y
- Total hours: Z

Polling Strategy

For regular sync, check:

/users/{username}/history?limit=5 - Recent activity
Compare with last known state
Update memory only if changes detected

---name: trakt-tvdescription: Trakt.tv integration for tracking movies and TV shows. Use when syncing watch history, checking what user is watching, updating watchlists, or integrating Trakt data into memory. Triggers on "trakt", "watch history", "what am I watching", "TV shows", "movies watched".---# Trakt.tv SkillSync and track movies/TV shows via Trakt.tv API.## SetupRequired environment variables:- `TRAKT_CLIENT_ID`: Get from https://trakt.tv/oauth/applications (create app, use Client ID)- `TRAKT_USERNAME`: Your Trakt username (profile must be public, or use OAuth for private)## API EndpointsBase URL: `https://api.trakt.tv`Headers required:```Content-Type: application/jsontrakt-api-version: 2trakt-api-key: {TRAKT_CLIENT_ID}```## Common Operations### Get Watch History```bashcurl -s "https://api.trakt.tv/users/{username}/history?limit=10" \ -H "Content-Type: application/json" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"```### Get Currently Watching```bashcurl -s "https://api.trakt.tv/users/{username}/watching" \ -H "Content-Type: application/json" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"```### Get Watchlist```bashcurl -s "https://api.trakt.tv/users/{username}/watchlist" \ -H "Content-Type: application/json" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"```### Get Watched Shows (with progress)```bashcurl -s "https://api.trakt.tv/users/{username}/watched/shows" \ -H "Content-Type: application/json" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"```### Get Watched Movies```bashcurl -s "https://api.trakt.tv/users/{username}/watched/movies" \ -H "Content-Type: application/json" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"```### Get Ratings```bashcurl -s "https://api.trakt.tv/users/{username}/ratings" \ -H "Content-Type: application/json" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"```### Get Stats```bashcurl -s "https://api.trakt.tv/users/{username}/stats" \ -H "Content-Type: application/json" \ -H "trakt-api-version: 2" \ -H "trakt-api-key: $TRAKT_CLIENT_ID"```## Memory IntegrationWhen syncing to memory, create/update a file like `entertainment.md`:```markdown# Entertainment## Currently Watching- **Show Name** - Season X, Episode Y (last watched: DATE)## Recently Watched- Movie Name (DATE) - ⭐ RATING/10## Watchlist- Show/Movie to watch## Stats- Total shows: X- Total movies: Y- Total hours: Z```## Polling StrategyFor regular sync, check:1. `/users/{username}/history?limit=5` - Recent activity2. Compare with last known state3. Update memory only if changes detected

Frequently asked questions