Engine DJ Library Assistant (unofficial) MCP server

engine-dj-mcp

Ask Claude, or any AI assistant, about your Engine DJ library: find tracks by BPM, key, genre or your own comments, check the collection for duplicates, missing files and tracks with no cues, read the cues and beatgrids Engine stored, and have playlists built or track tags fixed when you ask. It works through MCP, the Model Context Protocol, the standard way AI apps such as Claude Desktop, Claude Code, Cursor and VS Code connect to tools on your own computer: the app starts this server, and the assistant calls it when a question needs your library.

It reads the library on your computer and the ones on your USB drives. It opens them read-only at the operating-system level and changes nothing unless you start it with --allow-writes — then it can create and edit playlists and edit genre, comment, label, year and rating, and it copies the whole database to a backup before the first change. See Safety. The server itself sends nothing anywhere; what your AI app does with its answers is covered in PRIVACY.md.

Status: Active · Pre-1.0. In regular use and maintained; before 1.0 a MINOR release may change behaviour, a PATCH never does. Changes are recorded in CHANGELOG.md.

**Not affiliated with, endorsed by, or sponsored by inMusic Brands, Denon

DJ, or the Engine DJ product.** "Engine DJ" is used here only to name the

software whose library this tool reads and writes. No logos or brand

artwork from inMusic or Denon DJ are used in this project.

What you can ask

Once connected, these are ordinary questions in chat:

• "Something dark around 124 in a minor key I haven't played in six months."
• "Find me anything harmonically compatible with 8A between 138 and 142."
• "What's broken in my collection — missing files, duplicates, tracks with no cues?"
• "Where are the cue points on this track, and what tempo did Engine analyse?"
• "Build me a playlist of everything in 5A from 140 BPM up." (needs --allow-writes)
• "Set the genre of these five tracks to Minimal and rate them four stars." (needs --allow-writes)

Install

You need Node.js 22.16 or newer. There is nothing else to install: every app below starts the server with npx, which downloads it from npm the first time.

npx engine-dj-mcp

That command is what the apps run; you do not need to run it yourself.

Claude Desktop

Settings → Developer → Edit Config, and add to claudedesktopconfig.json:

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

Restart Claude Desktop.

Claude Code

claude mcp add --scope user engine-dj -- npx -y engine-dj-mcp

Cursor

Add to Cursor — or open this deep link directly, or add the same mcpServers entry as for Claude Desktop to ~/.cursor/mcp.json:

cursor://anysphere.cursor-deeplink/mcp/install?name=engine-dj&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImVuZ2luZS1kai1tY3AiXX0%3D

VS Code

Add to VS Code — or run:

code --add-mcp '{"name":"engine-dj","command":"npx","args":["-y","engine-dj-mcp"]}'

Letting it write

Shortened. The full README is on GitHub.