Skip to content
MCP server

Engine DJ Library Assistant (unofficial)

Ask AI about your Engine DJ track library: BPM and key search, audits, cues, opt-in edits

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, CLI
Runs
Locally
Version
0.18.0
Listing updated
1 day ago

About Engine DJ Library Assistant (unofficial)

Engine DJ Library Assistant (unofficial) is an open-source MCP server for events and entertainment. It runs locally on your machine and is started by your AI client.

This unofficial server reads the Engine DJ databases on your own computer and on connected USB drives, opening them read-only at the operating-system level. The assistant can find tracks by tempo, Camelot key, rating, last-played date or free text, and the search folds diacritics, so a query for bjork matches Bjork with the accent, which Engine's own search does not. It can also audit a collection for duplicates, missing files and tracks with no cues, and read stored cues and beatgrids.

Nine tools only read. Five more, for creating and editing playlists and updating genre, comment, label, year and rating, appear only if you start the server with --allow-writes, and the whole database is copied to a backup before the first change. The README advises pinning the version when writes are enabled and quitting Engine DJ first.

Currently only macOS is supported, and libraries at schema 3.0.0 to 3.0.2 (Engine DJ 4.5 and 5.x) are accepted; anything else is refused. It needs Node.js 22.16 or newer and sends nothing anywhere itself. It is not affiliated with inMusic or Denon DJ.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "engine-dj-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "engine-dj-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "engine-dj-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "engine-dj-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "engine-dj-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "engine-dj-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

search_tracks
Full-text search with tempo, key, rating, played and added filters.
get_tracks
Returns full metadata for specific track ids.
get_playlists
Returns the playlist tree in Engine DJ order.
create_playlist
Creates a playlist; needs --allow-writes.
add_tracks_to_playlist
Adds tracks to a playlist; needs --allow-writes.
remove_tracks_from_playlist
Removes tracks from a playlist; needs --allow-writes.
reorder_playlist
Reorders a playlist; needs --allow-writes.
update_track_metadata
Edits genre, comment, label, year and rating; needs --allow-writes.

What it does

Tempo and key search
Filters by BPM range or tolerance and by exact or harmonically compatible Camelot keys.
Collection audit
Finds duplicates, missing files and tracks without cues.
Cues and beatgrids
Reads the cues and beatgrids that Engine stored.
Read-only by default
Opens libraries read-only unless started with --allow-writes.
Backup before edits
Copies the database before the first change.
Playlist and tag edits
Creates playlists and edits genre, comment, label, year and rating when allowed.

Good for

  • Find tracks compatible with a given key within a BPM range
  • Clean up a library by listing duplicates and missing files
  • Build a playlist from a key and tempo rule
  • Batch-set genre and rating on selected tracks

Pricing

Open source

Engine DJ Library Assistant (unofficial) FAQ

Which operating systems work?

macOS only for now; Windows and Linux are not supported yet.

Can it change my library?

Only if you add --allow-writes; otherwise libraries are opened read-only.

What Node.js version is needed?

Node.js 22.16 or newer.

Is it affiliated with Engine DJ?

No, the README says it is not affiliated with inMusic, Denon DJ or Engine DJ.

Is Engine DJ Library Assistant (unofficial) free?

Yes. Engine DJ Library Assistant (unofficial) is open source, so you can use and self-host it for free.

How do I add Engine DJ Library Assistant (unofficial) to Claude Code?

Run this command in your terminal: claude mcp add engine-dj-mcp -- npx -y engine-dj-mcp

What are the best alternatives to Engine DJ Library Assistant (unofficial)?

The closest alternatives to Engine DJ Library Assistant (unofficial) are MaineMCP, Agent Bookability Index, Tap2Cal, Veseljko katalog usluga za proslave and 숏츠생성기 Free K-pop Shorts.

Alternatives to Engine DJ Library Assistant (unofficial)

  1. MaineMCP

    MCP server

    Search public Maine events, communities and startups, with links to the source listings

    • 4 tools
    • Remote
    • Free
    • Events and entertainment
  2. NYC-area event vendor prices, areas and booking options sourced from vendor sites

    • 9 tools
    • Remote
    • Free
    • Events and entertainment
  3. Tap2Cal

    MCP server

    Create shareable add-to-calendar links and read RSVPs from your AI assistant

    Not checked yet
    • 9 tools
    • Remote
    • Free
    • Productivity
  4. Search Croatian wedding and party venues, bands, photographers and caterers

    • 5 tools
    • Remote
    • Free
    • Events and entertainment
  5. Free finished K-pop shorts with title, description and thumbnail for YouTube Shorts

    • 3 tools
    • Remote
    • Free
    • Design and media