rewind-mcp-server

0.9.0 verified Fri May 01 auth: no javascript

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.

Common errors

error Error: Missing REWIND_API_KEY environment variable ↓

cause Server started without the required API key.

fix

Set REWIND_API_KEY=<your_key> before running npx.

error Tool 'get_top_albums' not found ↓

cause Using an older client or misspelled tool name.

fix

Verify tool list via server capabilities or use npx -y rewind-mcp-server@0.9.0.

error Failed to fetch recent watches ↓

cause Missing/wrong Plex or Letterboxd integration token.

fix

Ensure Rewind has access to your media sources in the Rewind dashboard.

Warnings

gotcha Do NOT run without setting REWIND_API_KEY — the server will fail to start or return authentication errors. ↓

fix Set REWIND_API_KEY env variable to a valid Rewind API key as documented.

breaking Major version 0.x — breaking changes can occur at any minor/patch release. Always pin version in production. ↓

fix Pin to specific version (e.g., rew-mcp-server@0.9.0) in package.json or CI.

gotcha The server uses npx -y which always fetches the latest version. Avoid in production without explicit version pinning. ↓

fix Use full path to installed binary or npx rewind-mcp-server@0.9.0.

deprecated Old v0.7.x tools may have been renamed or removed in v0.8+. Check docs for current tool list. ↓

fix Migrate to v0.9.0 and update any hardcoded tool names per changelog.

gotcha Remote MCP endpoint (https://mcp.rewind.rest/mcp) may have different capabilities than local server. Some features limited. ↓

fix Test remote vs local behavior before relying on a specific feature.

Install

npm install rewind-mcp-server

yarn add rewind-mcp-server

pnpm add rewind-mcp-server

Imports

rewind-mcp-server
wrong
```
const server = require('rewind-mcp-server')
```
correct
```
Use via npx: npx -y rewind-mcp-server
```
This package is an MCP server binary, not a library. Do not import programmatically.

MCP server config

wrong

Using "command": "rewind-mcp-server" without npx or installed globally

correct

{
  "mcpServers": {
    "rewind": {
      "command": "npx",
      "args": ["-y", "rewind-mcp-server"],
      "env": {
        "REWIND_API_KEY": "rw_live_your_key_here"
      }
    }
  }
}

Always use npx -y to ensure latest version. Provide API key via env.

TypeScript types

wrong

Attempting @types/rewind-mcp-server

correct

TypeScript types are shipped with the package for tool argument shapes

Types are bundled, no separate @types package needed.

Quickstart

Setup MCP client configuration for rewind-mcp-server, requiring REWIND_API_KEY environment variable.

// 1. Install or use via npx:
// npx -y rewind-mcp-server

// 2. Configure MCP client (e.g., Claude Desktop):
{
  "mcpServers": {
    "rewind": {
      "command": "npx",
      "args": ["-y", "rewind-mcp-server"],
      "env": {
        "REWIND_API_KEY": "rw_live_your_key_here"
      }
    }
  }
}

// 3. Example tool call (Claude will automatically use):
//   "What was my top album last month?"
//   Invokes: get_top_albums(period: '1month', limit: 1)

// 4. For mobile/web clients, use remote URL:
//   URL: https://mcp.rewind.rest/mcp
//   Authorization: Bearer rw_live_your_key_here