rekordbox-serato-bridge
This server moves DJ library data (cues, loops, colors, playlists) between Rekordbox and Serato via MCP tools and CLI.
Preview Rekordbox → Serato conversion (read-only).
Preview Serato → Rekordbox conversion (read-only).
Stage Serato cues into a verified copy of a single track without touching originals or databases.
List playlists/sets in the local Rekordbox database.
Convert a Rekordbox set into a Serato-ready output folder with copies, cues/loops, BeatGrid tags, and a .crate playlist.
Convert a Serato set back to Rekordbox via dry-run, direct database write (
--apply), or Rekordbox-compatible XML export.Works with local Rekordbox libraries, USB device libraries, and Serato's master.sqlite.
Supports MP3, AIFF/AIFC, FLAC (reads/writes) and WAV (reads cues).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rekordbox-serato-bridge preview converting my Rekordbox set 'Friday' to Serato"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Rekordbox ⇄ Serato Bridge
An MCP server that moves DJ library data — cues, loops, cue colors and playlists — between Rekordbox 6/7 and Serato DJ Pro, in both directions.
在 Rekordbox 6/7 与 Serato DJ Pro 之间双向搬运 DJ 资料库数据:Cue、Loop、Cue 颜色与播放列表。
Works with any MCP-compatible agent or client.
Platform support: macOS — supported (developed & verified on this machine) · Windows — unverified (paths are cross-platform in the codebase, but no real-machine testing yet).
Features
Both directions. Rekordbox → Serato (a Serato-ready folder + crate) and Serato → Rekordbox (your local Rekordbox library, or a Rekordbox-compatible XML export).
Cues, loops and colors. Hot cues, memory cues, saved loops, beat-length loops and cue colors are carried over into the target app's native model.
Works with USB exports. Cues can be read straight from a Rekordbox device library (
PIONEER/USBANLZ), so a USB stick converts without the desktop library.Read-only by default. Nothing is written until you ask for it, and audio files are only ever touched in staging copies.
Every write is previewable. Dry runs plus a machine-readable report for each conversion.
Related MCP server: spotify-dj
Requirements
OS | macOS (tested with Rekordbox 7 and Serato DJ Pro 4.0) |
Python | 3.9 or newer |
Rekordbox | 6 or 7 (needed for the Serato → Rekordbox direction) |
Serato | Serato DJ Pro 4.x |
pyrekordbox is installed automatically with the plugin.
Install
As a Codex plugin
codex plugin marketplace add shadowroommusic/rekordbox-serato-bridge
codex plugin add rekordbox-serato-bridge@shadowroomIn any other MCP client
{
"mcpServers": {
"rekordbox-serato-bridge": {
"command": "python3",
"args": ["mcp_server.py"],
"cwd": "/path/to/rekordbox-serato-bridge"
}
}
}CLI only
python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/shadow-rb-serato --helpConfiguration
Option | Default | Used for |
|
| reading/writing the Rekordbox library |
|
| Rekordbox settings + local analysis data |
|
| Serato crates and assets |
| – | a Rekordbox USB device, e.g. |
| – | where tagged copies are written |
Tools
Tool | What it does |
| Dry run: what a Rekordbox → Serato conversion would change |
| Dry run: what a Serato → Rekordbox conversion would change |
| Copy a track, write Serato cues into the copy, verify it, write a manifest |
| List the playlists in the local Rekordbox library |
| Rekordbox set → Serato-ready folder (copies + cues/loops + |
| Serato crate → Rekordbox (dry run, |
The same functionality is available from the CLI: preview-rb-to-serato, preview-serato-to-rb,
stage-cues, inspect-rekordbox, inspect-serato, list-sets, convert-set.
Usage
Rekordbox → Serato (gig folder or USB stick)
# from a Rekordbox device library (the cue data on the device is authoritative)
.venv/bin/shadow-rb-serato convert-set --to serato --name "My set" \
--out ~/Music/ShadowRoom-USB --device-root /Volumes/USB --with-cues-only
# or from a playlist in the local library
.venv/bin/shadow-rb-serato list-sets --rekordbox-database "$HOME/Library/Pioneer/rekordbox/master.db" \
--rekordbox-dir "$HOME/Library/Pioneer/rekordbox"The output is a folder Serato understands:
<out>/ShadowRoom/<set>/<tracks> # copies carrying Serato cues/loops + BeatGrid
<out>/ShadowRoom/<set>/manifest.json
<out>/_Serato_/Subcrates/<set>.crate # the crate Serato shows in its sidebarCopy the whole <out> folder to the root of your USB stick, or import the tracks into Serato —
either way the cues come along.
Serato → Rekordbox
SHADOW=.venv/bin/shadow-rb-serato
RB="$HOME/Library/Pioneer/rekordbox"
# 1) dry run
$SHADOW convert-set --to rekordbox --name "My set" \
--serato-database "$HOME/Library/Application Support/Serato/Library/master.sqlite" \
--rekordbox-database "$RB/master.db" --rekordbox-dir "$RB"
# 2) write (quit Rekordbox first; master.db is backed up automatically)
$SHADOW convert-set --to rekordbox --name "My set" --apply ...
# prefer not to touch the database? export Rekordbox-compatible XML instead
$SHADOW convert-set --to rekordbox --name "My set" --xml ~/Desktop/my-set.xml ...Previews and single-track staging
# side-by-side preview of both libraries
$SHADOW preview-rb-to-serato --rekordbox-database "$RB/master.db" --rekordbox-dir "$RB" \
--serato-database "$HOME/Library/Application Support/Serato/Library/master.sqlite" --output preview.json
# write cues into a verified staging copy only
$SHADOW stage-cues --track "/path/track.aiff" --cues cues.json --staging-dir ./stagingcues.json is either an array or {"cues": [...]}; each entry supports name, position_ms,
end_ms (loop) and color (#RRGGBB or an integer).
Supported file formats
Container | Read cues | Write cues |
MP3 | ✅ | ✅ |
AIFF / AIFC | ✅ | ✅ |
FLAC | ✅ | ✅ |
WAV | ✅ | – |
OGG | – | – |
Safety
Read-only unless you explicitly opt in (
--apply/"apply": true) or point a tool at a staging directory.Writes to the Rekordbox database back up
master.db(plus WAL/SHM) first and verify the result afterwards. Rekordbox must be closed while its database is written; the tool refuses otherwise.Audio files are never modified in place — new tags go into copies, and the report proves the source file is untouched.
Troubleshooting
Symptom | What to do |
| Quit Rekordbox and run the command again. |
Cues not visible in Serato | Reload the track (Serato reads tags when a track is loaded) and make sure the crate/folder was imported. |
Tracks listed as missing | The library points at a path that is not mounted (for example an unplugged USB stick). |
Device tracks not found | Mount the Rekordbox device, or convert from the local library instead. |
Contributing
See CONTRIBUTING.md. Implementation notes for maintainers live in docs/internals.md.
License
AGPL-3.0 — see LICENSE. Bundled dependency pyrekordbox is MIT licensed.
Available Tools
6 toolsconvert_setC
Convert a Rekordbox set into a Serato-ready output folder: copies with Serato Markers2 cues/loops, BeatGrid tags and a .crate playlist.
Inputs: name (required), out_dir (required), tracks, playlist, +6 more.
convert_set_to_rekordboxA
Convert a Serato set back into Rekordbox: dry-run the database write, export a Rekordbox XML, or apply with automatic backup.
Inputs: serato_database (required), name, apply, set_name, +3 more.
list_setsC
List the playlists (sets) in a local Rekordbox database.
Inputs: rekordbox_dir (required), rekordbox_database (required).
preview_rekordbox_to_seratoB
Create a read-only Rekordbox to Serato conversion preview.
Inputs: rekordbox_dir (required), serato_database (required), rekordbox_database (required).
preview_serato_to_rekordboxB
Create a read-only Serato to Rekordbox conversion preview.
Inputs: rekordbox_dir (required), serato_database (required), rekordbox_database (required).
stage_serato_cuesA
Write cues into a STAGING COPY of one track as Serato Markers2, then read them back to verify. The original file and both vendor databases are never touched.
Inputs: cues (required), track (required), staging_dir (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
The two preview tools are clearly directional, stage_serato_cues and list_sets are distinct, but convert_set and convert_set_to_rekordbox are asymmetric: convert_set is really Rekordbox→Serato yet its name omits the direction, which could make an agent wonder if it is the generic/bidirectional counterpart to convert_set_to_rekordbox.
All snake_case, verb-first (preview_, stage_, list_, convert_), which is consistent; the only deviation is the asymmetric direction suffix where convert_set_to_rekordbox names its direction but convert_set does not, despite both being directional operations.
Six tools is well-scoped for a two-way format bridge: preview both directions, convert both directions, a staging write, and a set lister. Each tool earns its place with no redundancy.
Covers the full lifecycle for both directions (list, preview, convert, plus safe staging and backup-on-apply), but lacks any track-level inspection/listing or explicit rollback/undo tool, which agents might need for verification beyond the built-in backup.
Maintenance
Related MCP Connectors
Convert subtitles, transcripts, broadcast captions (SCC/MCC/STL), EDLs, and Premiere files.
Read and edit DAW projects as an agent, save native Logic projects, convert projects between DAWs
Validate and convert JSONL fine-tuning data across 11 AI providers. 13 tools.
Free licensed loops and authorized audio analysis: BPM, key, waveform. Estimate before paid use.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables safety-first live control of Rekordbox over a virtual MIDI port, with armed transitions, dry-run preview, and emergency stop.-
- AlicenseNot gradedqualityBmaintenanceEnables DJs to retrieve BPM, key/Camelot, energy, and other track metadata with provider provenance, score transitions, plan setlists, and control Spotify playlists and playback with staged, revalidated writes for safety.MIT
- AlicenseAqualityAmaintenanceEnables AI assistants to query and manage a local Engine DJ library on macOS, including searching tracks by BPM, key, genre, or comments, auditing duplicates and missing files, reading cues and beatgrids, and building playlists or fixing tags when write access is enabled.996 npm1MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to search and audit a Serato DJ library by BPM and Camelot key, browse crates, detect duplicates and missing files, and stage new crates for review before writing.663 npm2MIT