Rekordbox

You run an MCP server that provides real-time access to your rekordbox library, enabling powerful search, analytics, and playlist management while keeping your data safe with built-in backups and safety features.

How to use

You interact with the Rekordbox MCP Server using an MCP client. Start the server locally and connect your client to the available MCP endpoint to perform read operations, browse and search tracks, view library analytics, and manage playlists. Mutation actions (like creating or editing playlists) include automatic backups and safety annotations to protect your data. For best results, ensure you have a complete rekordbox backup before making any changes.

How to install

Prerequisites you need to meet before installation are listed here so you can prepare your environment.

# Install dependencies with uv
uv sync

# Run the server
uv run rekordbox-mcp

Configuration

Configure the server to auto-detect your rekordbox database or specify a custom path. Auto-detection is recommended to simplify setup, but you can point to a specific database if needed.

# Auto-detect rekordbox database (recommended)
uv run rekordbox-mcp

# Specify custom database path
uv run rekordbox-mcp --database-path /path/to/rekordbox/Pioneer

Client setup and usage notes

To use with your Claude Desktop configuration, add an MCP server entry that runs the MCP server locally. This connects your client to the Rekordbox MCP Server and enables the full set of search, analytics, and playlist management capabilities.

{
  "mcpServers": {
    "rekordbox-database": {
      "command": "uv",
      "args": ["run", "rekordbox-mcp"],
      "cwd": "/path/to/rekordbox-mcp"
    }
  }
}

Safety and backups

Before performing mutations, every operation creates an automatic backup of the rekordbox database. Always verify backups exist and test changes on backup copies before applying them to your main library.

Examples and common workflows

Common workflows include searching tracks by multiple fields, examining library statistics, and batch-adding tracks to playlists with safety protections enabled. Use the available tools to retrieve library insights, manage playlists, and query DJ history.

Available tools

search_tracks

Advanced multi-field search with filtering across artist, title, genre, key, BPM, rating, and more.

get_library_stats

Comprehensive library statistics and analytics, including genre distribution and average BPM.

get_playlists

List all playlists including smart playlists.

get_playlist_tracks

Retrieve all tracks in a specific playlist.

create_playlist

Create a new playlist with safety protections.

add_track_to_playlist

Add a single track to a playlist with safety checks.

add_tracks_to_playlist

Add multiple tracks to a playlist in a single operation.

remove_track_from_playlist

Remove a track from a playlist.

delete_playlist

Delete a playlist permanently with safety confirmation.

get_recent_sessions

Access recent DJ sessions and performance data.

get_session_tracks

Get all tracks played in a specific DJ session.

get_history_stats

Comprehensive DJ performance statistics and insights.

database-status

Current connection status and basic database stats.