Venut-Technologies/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:
"Build a crate called Friday Opening from the twenty tracks you just found, and show me the
list before writing anything." Then, once you have closed Serato: "Apply the staged crate."
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.
json
"mcpServers": {
"serato": {
"command": "npx",
"args": ["-y", "serato-dj-mcp"]
### Claude Code
sh
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
Add to Cursor,
or add the same mcpServers entry as for Claude Desktop to ~/.cursor/mcp.json. The link opens
cursor://anysphere.cursor-deeplink/mcp/install?name=serato&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNlcmF0by1kai1tY3AiXX0=,
which asks Cursor to add {"command":"npx","args":["-y","serato-dj-mcp"]} under the name serato.