Trakt

🚀 Trakt Integration Guide for MCP Server

This guide provides a comprehensive walk - through on integrating Trakt with the MCP server, enabling you to access real - time Trakt data and enhance your media - related interactions.

🚀 Quick Start

The following steps will guide you through the process of setting up and running the MCP server integrated with Trakt.

📦 Installation

Clone the Repository

git clone https://github.com/yourusername/mcp-trakt.git
cd mcp-trakt

Install Dependencies

pip install -r requirements.txt

Configure the Environment

Copy and edit the .env file:

cp .env.example .env

Then add your Trakt API credentials to the .env file:

TRAKT_CLIENT_ID=your_client_id
TRAKT_CLIENT_SECRET=your_client_secret

Start the Server

python server.py

🛠️ Development and Testing

Test with the MCP Check Tool

mcp dev server.py

Install in Claude Desktop

mcp install server.py

💻 Usage Examples

Interacting with Claude

You can ask Claude the following questions:

• "What shows are currently trending?"
• "Can you recommend some popular movies?"
• "What are the highest - watched TV shows this month?"
• "Show me all the shows I've watched" (Requires authentication).
• "What was the last show I watched?" (Requires authentication).
• "Show me all the movies I've watched" (Requires authentication).
• "What was the last movie I watched?" (Requires authentication).
• "Search for TV shows similar to 'Breaking Bad'."
• "Check - in to the currently watched Breaking Bad Season 2, Episode 5" (Using the title).
• "Check - in to Breaking Bad Season 1, Episode 3 and share it on Twitter" (Using the ID).

Claude will leverage this MCP server to provide you with real - time Trakt data.

✨ Features

Core Features

1. Device Authentication Process:

   • Authentication is automatically triggered when requesting user data.
   • After receiving the code and link, visit the browser to complete the authorization.
   • Notify Claude upon successful authorization and then retrieve personal data.
   • Authentication tokens are securely stored for future use.

2. User Data Access:

   • View the complete watch history (both TV shows and movies).
   • Get the last watched time for each work.
   • Count the number of views for each work.
   • Track the current watch progress and check - in.
   • Record personal watch statistics.

3. Social Sharing:

   • Option to share on Twitter, Mastodon, or Tumblr when checking - in.

Future Development

• Expand authentication capabilities to access more personal data.
• Add calendar reminders for upcoming TV shows.
• Support automatic watch progress tracking (Scrobbling).
• Provide personalized recommendations based on watch history.
• Add a movie search function.
• Expand support for more social platforms.

📄 License

MIT License