Serato DJ library MCP server

serato-dj-mcp

Ask Claude about your Serato DJ library: find tracks that mix harmonically by BPM and Camelot key, browse your crates, audit the library for duplicates and missing files, and have new crates built for you, shown to you before anything is written. It works through the Model Context Protocol (MCP), the standard way AI apps such as Claude Desktop, Claude Code, Cursor and VS Code connect to tools on your computer: this is a small local server that answers from your library and sends nothing anywhere itself.

Status: experimental. Pre-1.0 and actively developed: a minor version may change behaviour or break compatibility, a patch never does.

[!IMPORTANT]

Not affiliated with, endorsed by, or supported by Serato. Serato and Serato DJ are

trademarks of their respective owner. This project reads a reverse-engineered database layout

and can stop working after any Serato update.

What you can ask

Once the server is connected, you talk to your assistant as usual:

• "Find tracks between 122 and 126 BPM in 8A or 9A that I added this year."
• "Give me tracks that mix harmonically out of 8A, around 124 BPM."
• "Show me what's in my Warm Up crate, in order."
• "Audit my library: duplicates, missing files, tracks that aren't in any crate."
• "Which tracks in my library have no BPM or no key?"

With crate writing switched on:

list before writing anything." Then, once you have closed Serato: "Apply the staged crate."

• "Build a crate called Friday Opening from the twenty tracks you just found, and show me the

The assistant does the searching; the server answers from your library and, when asked, writes only what you approved.

Install

Works on macOS. Tested with Serato DJ Lite 4.0.9 on macOS; the test suite runs in CI on macOS and Linux with Node.js 22.16 and 24. Windows is untested — see Compatibility. The Claude Desktop extension and the Claude Code setup below were tried by hand on macOS; the Cursor and VS Code setups follow those editors' documentation and have not been tried.

Every setup starts the server read-only. Crate writing is a separate switch, described below.

Claude Desktop

As an extension (no Node.js needed). Download serato-dj-mcp-.mcpb from the latest release (attached from version 0.1.1 on) and open it; Claude Desktop shows what it contains and installs it. Its settings let you point it at a library folder and switch on crate writing or raw SQL; all three can stay as they are.

Or by hand, with Node.js 22.16 or newer installed: open Settings → Developer → Edit Config and add the server to claudedesktopconfig.json, then restart Claude Desktop.

{
  "mcpServers": {
    "serato": {
      "command": "npx",
      "args": ["-y", "serato-dj-mcp"]
    }
  }
}

Claude Code

claude mcp add serato -- npx -y serato-dj-mcp

Add --scope user before serato to have it in every project. The repository is also a Claude Code plugin that starts the same command.

Cursor

Shortened. The full README is on GitHub.