simkl-mcp
model context protocol server for simkl
unofficial
what is this?
this is an mcp (model context protocol) server that provides claude with access to simkl for tracking movies, tv shows, and anime.
built with cloudflare agents sdk and autogenerated from openapi spec - 28 tools (27 generated + 1 custom), zero manual parameter wiring.
available tools (28) & resources
⏺ simkl_search_by_text search by text query (tv/movie/anime)
⏺ simkl_search_by_id lookup by external id (imdb/tmdb/mal/anidb/tvdb)
⏺ simkl_start_watching start watching
⏺ simkl_pause_watching pause and save progress
⏺ simkl_stop_watching stop watching
⏺ simkl_add_to_watchlist add to watchlist
⏺ simkl_mark_watched mark as watched
⏺ simkl_remove_from_history remove from watch history
⏺ simkl_add_rating add rating (1-10)
⏺ simkl_remove_rating remove rating
⏺ simkl_get_trending_shows trending tv shows
⏺ simkl_get_trending_movies trending movies
⏺ simkl_get_trending_anime trending anime
⏺ simkl_get_best_shows best-rated tv shows
⏺ simkl_get_best_anime best-rated anime
⏺ simkl_get_airing_shows airing tv shows
⏺ simkl_get_airing_anime airing anime
⏺ simkl_get_show_by_id show details by id
⏺ simkl_get_movie_by_id movie details by id
⏺ simkl_get_anime_by_id anime details by id
⏺ simkl_get_show_episodes episode list for shows
⏺ simkl_get_anime_episodes episode list for anime
⏺ simkl_get_shows_by_genre shows by genre
⏺ simkl_get_anime_by_genre anime by genre
⏺ simkl_get_movies_by_genre movies by genre
⏺ simkl_get_user_stats stats for a user
⏺ simkl_get_watchlist get watchlist items
⏺ simkl_my_stats custom user stats helper
resources: watchlist/{type}/{status}, trending/{type}/{interval}
setup instructions
local (sse) - bun + wrangler
bun install
bun run dev{
"mcpServers": {
"simkl": {
"transport": "sse",
"url": "http://localhost:8787/sse"
}
}
}deploy to cloudflare workers
wrangler secret put SIMKL_CLIENT_ID
wrangler secret put SIMKL_CLIENT_SECRET
wrangler secret put OAUTH_REDIRECT_URI
bun run deployset
SIMKL_CLIENT_ID, SIMKL_CLIENT_SECRET, and OAUTH_REDIRECT_URI either in .dev.vars (local) or wrangler secrets (prod). sse endpoint: /sse; oauth entrypoint: /auth/simkl.features
- 27 autogenerated tools + 1 custom user stats helper
- search, scrobble, sync, and discover content
- oauth authentication flow
- cloudflare workers + durable objects
- zero manual parameter definitions