Registry / llm-agents / rewind-mcp-server

rewind-mcp-server

library0.9.0jsnpmunverified

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.

llm-agents aws

npm install rewind-mcp-server

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · REWIND-MCP-SERVER

rewind-mcp-server

llm-agentsjavascriptv0.9.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

rewind-mcp-server

✓ Use via npx: npx -y rewind-mcp-server

✗ const server = require('rewind-mcp-server')

This package is an MCP server binary, not a library. Do not import programmatically.

MCP server config

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

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

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

TypeScript types

✓ TypeScript types are shipped with the package for tool argument shapes

✗ Attempting @types/rewind-mcp-server

Types are bundled, no separate @types package needed.

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

rewind-mcp-server --version

Debug

Known issues

gotchaDo 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.

affects: >=0.1.0

breakingMajor 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.

affects: >=0.0.0

gotchaThe 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.

affects: >=0.1.0

deprecatedOld 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.

affects: <0.8.0

gotchaRemote 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.

affects: >=0.1.0

Errors

Common errors & fixes

Error: Missing REWIND_API_KEY environment variable

Server started without the required API key.

fix

Set REWIND_API_KEY=<your_key> before running npx.

Tool 'get_top_albums' not found

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.

Failed to fetch recent watches

Missing/wrong Plex or Letterboxd integration token.

fix

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

Upgrade

Version history

0.9.0latest on npm

Audit

Dependencies

@modelcontextprotocol/sdkrequiredCore MCP server SDK for tool/prompt/resource definitions

zodrequiredSchema validation for tool inputs and API responses

Agent activity

22 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/pdugan20/rewind ↗

packagehttps://www.npmjs.com/package/rewind-mcp-server ↗

homepagehttps://rewind.rest ↗