# Engine DJ Library Assistant (unofficial)

> Engine DJ Library Assistant (unofficial) is an open-source MCP server for events and entertainment. Ask AI about your Engine DJ track library: BPM and key search, audits, cues, opt-in edits. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, CLI
- **Repository:** https://github.com/venut-technologies/engine-dj-mcp
- **MCP Registry name:** io.github.Venut-Technologies/engine-dj-mcp
- **Categories:** events and entertainment
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.
- [Tap2Cal](https://ai-powered.com/mcp/tap2cal): Tap2Cal is a free MCP server for productivity.
- [Veseljko katalog usluga za proslave](https://ai-powered.com/mcp/veseljko-katalog-usluga-za-proslave): Veseljko katalog usluga za proslave is a free MCP server for events and entertainment.
- [숏츠생성기 Free K-pop Shorts](https://ai-powered.com/mcp/free-k-pop-shorts): 숏츠생성기 Free K-pop Shorts is a free MCP server for design and media.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Last.fm MCP](https://ai-powered.com/mcp/last-fm-mcp): Last.fm MCP is an open-source MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/engine-dj-library-assistant-unofficial
