reklawdbox

Manage your Rekordbox library with AI through the Model Context Protocol. reklawdbox connects any MCP-compatible host — Claude Code, Claude Desktop, Codex — to your collection.

Getting Started Install, configure, and connect reklawdbox to your MCP host.

Concepts Architecture, safety model, and how harmonic mixing works.

Workflows Genre classification, set building, and collection audits.

MCP Tools All 51 tools grouped by function — library, enrichment, staging, mixing, and more.

CLI Standalone commands for batch enrichment, audio analysis, and file tag management.

Reference Environment variables, transition scoring math, and XML export details.

Troubleshooting Fix common setup, auth, and runtime problems.

What reklawdbox does

An MCP server between your AI agent and Rekordbox 7.x. The database is read-only — all changes are staged in memory and exported as XML.

• Reads encrypted master.db directly via SQLCipher (read-only)
• Stages metadata changes (genre, comments, rating, color, label, year, album) for review before export
• Exports Rekordbox-compatible XML for safe reimport
• Enriches tracks via Discogs, Beatport, MusicBrainz, and Bandcamp — labels, years, artwork
• Analyzes audio with stratum-dsp + optional Essentia — BPM, key, energy, danceability
• Scores transitions and builds sets — harmonic compatibility, BPM, energy curves, genre affinity
• CLI subcommands for batch analysis and file tag operations outside MCP

51 MCP tools

Library & Data — read_library, search_tracks, get_track, get_playlists, get_playlist_tracks, get_sessions, get_session_tracks, get_play_stats, resolve_track_data, resolve_tracks_data, cache_coverage

Enrichment & Analysis — lookup_discogs, lookup_beatport, lookup_musicbrainz, lookup_bandcamp, enrich_tracks, analyze_track_audio, analyze_audio_batch, setup_essentia

Classification & Staging — get_genre_taxonomy, suggest_normalizations, classify_tracks, audit_genres, backfill_labels, backfill_years, backfill_albums, update_tracks, preview_changes, write_xml, clear_changes

Mixing & Sequencing — score_transition, query_transition_candidates, build_set, score_pool_compatibility, expand_pool, describe_pool, discover_pools, save_weight_preset, list_weight_presets, delete_weight_preset

Files & System — read_file_tags, write_file_tags, extract_cover_art, embed_cover_art, scan_broken_links, scan_orphan_files, scan_playlist_coverage, scan_duplicates, audit_state, clear_caches, help

7 CLI commands

hydrate, analyze, read-tags, write-tags, extract-art, embed-art, setup