@cassette.diy/mcp

MCP server for Cassette (music releases) and Cassette for Creators (short-form clips). Lets AI assistants in Cursor, Claude Desktop, and other MCP clients manage your Cassette account via personal access tokens.

npm: https://www.npmjs.com/package/@cassette.diy/mcp
Docs: https://cassette.diy/docs/mcp

Install

Published on npm. No separate install step when using Cursor — npx downloads the package on first run:

npx -y @cassette.diy/mcp

1. A Cassette or Creator account with Google Drive linked (required for uploads).

2. A personal access token from the web app:

   • Music app: Settings → API / AI access

   • Creator app: Settings → API / AI access

Related MCP server: mcp-media-engine

Cursor setup

Add to your Cursor MCP config (~/.cursor/mcp.json or project .cursor/mcp.json):

{
  "mcpServers": {
    "cassette": {
      "command": "npx",
      "args": ["-y", "@cassette.diy/mcp"],
      "env": {
        "CASSETTE_API_URL": "https://api.cassette.diy",
        "CASSETTE_API_TOKEN": "ct_live_YOUR_TOKEN_HERE",
        "CASSETTE_PRODUCT": "both"
      }
    }
  }
}

You can copy a ready-made snippet from Settings after creating a token.

Environment variables

Local development

From the monorepo:

cd cassette-mcp
npm install
npm run build

Point Cursor at the local package:

{
  "mcpServers": {
    "cassette": {
      "command": "node",
      "args": ["/absolute/path/to/Cassette/cassette-mcp/dist/index.js"],
      "env": {
        "CASSETTE_API_URL": "http://localhost:8080",
        "CASSETTE_API_TOKEN": "ct_live_...",
        "CASSETTE_PRODUCT": "both"
      }
    }
  }
}

Tool catalog

Set CASSETTE_PRODUCT to music, creator, or both (default: both).

Shared

Music — track creation workflow

Focused tools for musicians: create a release end-to-end (no delete, collaboration, or Drive sync).

Creators

Full clip workflow (unchanged):

Uploads

Upload tools read files from local_path on the machine running the MCP server (your computer when using stdio in Cursor).

• < 10 MB — direct multipart upload

• 10–20 MB — async upload + task polling

• > 20 MB (tracks) — chunked upload + task polling

If Drive is not linked, upload tools fail; use cassette_start_gdrive_link first.

Token scopes

Tokens cannot access admin, Stripe checkout, analytics, or token management endpoints.

Publish checklist

• Deploy backend with api_tokens collection and routes

• Verify token create/list/revoke in staging Settings UI

• Smoke-test MCP tools against staging API

• Publish @cassette.diy/mcp to npm (v0.1.0)

• Set production CASSETTE_API_URL in docs

• Optional: track mcp_token_created analytics event

License

UNLICENSED — internal Cassette package.