{"id":26318,"library":"rewind-mcp-server","title":"rewind-mcp-server","description":"MCP server (v0.9.0) that exposes personal data from Last.fm, Strava, Plex, Letterboxd, Discogs, Trakt, Instapaper, and calendar/Gmail through a unified Model Context Protocol interface. Allows AI assistants (Claude, ChatGPT, Gemini) to query listening stats, running activities, watched media, vinyl collection, reading highlights, and event attendance via tools and prompts. Ships TypeScript types, requires Node ≥18, and is actively maintained with frequent releases (weekly bugfixes/features). Key differentiator: aggregates multiple third-party APIs into a single MCP endpoint with semantic search, cross-domain queries, and inline interactive grids on supported MCP clients.","status":"active","version":"0.9.0","language":"javascript","source_language":"en","source_url":"https://github.com/pdugan20/rewind","tags":["javascript","mcp","mcp-server","rewind","personal-data","lastfm","strava","plex","discogs","typescript"],"install":[{"cmd":"npm install rewind-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add rewind-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add rewind-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core MCP server SDK for tool/prompt/resource definitions","package":"@modelcontextprotocol/sdk","optional":false},{"reason":"Schema validation for tool inputs and API responses","package":"zod","optional":false}],"imports":[{"note":"This package is an MCP server binary, not a library. Do not import programmatically.","wrong":"const server = require('rewind-mcp-server')","symbol":"rewind-mcp-server","correct":"Use via npx: npx -y rewind-mcp-server"},{"note":"Always use npx -y to ensure latest version. Provide API key via env.","wrong":"Using \"command\": \"rewind-mcp-server\" without npx or installed globally","symbol":"MCP server config","correct":"{\n  \"mcpServers\": {\n    \"rewind\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rewind-mcp-server\"],\n      \"env\": {\n        \"REWIND_API_KEY\": \"rw_live_your_key_here\"\n      }\n    }\n  }\n}"},{"note":"Types are bundled, no separate @types package needed.","wrong":"Attempting @types/rewind-mcp-server","symbol":"TypeScript types","correct":"TypeScript types are shipped with the package for tool argument shapes"}],"quickstart":{"code":"// 1. Install or use via npx:\n// npx -y rewind-mcp-server\n\n// 2. Configure MCP client (e.g., Claude Desktop):\n{\n  \"mcpServers\": {\n    \"rewind\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"rewind-mcp-server\"],\n      \"env\": {\n        \"REWIND_API_KEY\": \"rw_live_your_key_here\"\n      }\n    }\n  }\n}\n\n// 3. Example tool call (Claude will automatically use):\n//   \"What was my top album last month?\"\n//   Invokes: get_top_albums(period: '1month', limit: 1)\n\n// 4. For mobile/web clients, use remote URL:\n//   URL: https://mcp.rewind.rest/mcp\n//   Authorization: Bearer rw_live_your_key_here","lang":"json","description":"Setup MCP client configuration for rewind-mcp-server, requiring REWIND_API_KEY environment variable."},"warnings":[{"fix":"Set REWIND_API_KEY env variable to a valid Rewind API key as documented.","message":"Do NOT run without setting REWIND_API_KEY — the server will fail to start or return authentication errors.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Pin to specific version (e.g., rew-mcp-server@0.9.0) in package.json or CI.","message":"Major version 0.x — breaking changes can occur at any minor/patch release. Always pin version in production.","severity":"breaking","affected_versions":">=0.0.0"},{"fix":"Use full path to installed binary or npx rewind-mcp-server@0.9.0.","message":"The server uses npx -y which always fetches the latest version. Avoid in production without explicit version pinning.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Migrate to v0.9.0 and update any hardcoded tool names per changelog.","message":"Old v0.7.x tools may have been renamed or removed in v0.8+. Check docs for current tool list.","severity":"deprecated","affected_versions":"<0.8.0"},{"fix":"Test remote vs local behavior before relying on a specific feature.","message":"Remote MCP endpoint (https://mcp.rewind.rest/mcp) may have different capabilities than local server. Some features limited.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Set REWIND_API_KEY=<your_key> before running npx.","cause":"Server started without the required API key.","error":"Error: Missing REWIND_API_KEY environment variable"},{"fix":"Verify tool list via server capabilities or use npx -y rewind-mcp-server@0.9.0.","cause":"Using an older client or misspelled tool name.","error":"Tool 'get_top_albums' not found"},{"fix":"Ensure Rewind has access to your media sources in the Rewind dashboard.","cause":"Missing/wrong Plex or Letterboxd integration token.","error":"Failed to fetch recent watches"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}