Skip to content
reklawdbox reklawdbox

Install

Prerequisites

Section titled “Prerequisites”
  • macOS on Apple Silicon — M1 or later
  • Rekordbox 7.x installed with at least one collection imported
  • AI agent — one of:
    • Claude Code (recommended)
    • Claude Desktop and Codex — hopefully soon

Install

Section titled “Install”
Terminal window
brew tap ryan-voitiskis/reklawdbox
brew install reklawdbox

Setup

Section titled “Setup”
Terminal window
reklawdbox setup

This installs audio analysis tools (Essentia) and configures both Claude Code and Claude Desktop so the agent can use reklawdbox.

Start a conversation

Section titled “Start a conversation”

For Claude Code, start it from your Music directory:

Terminal window
cd ~/Music && claude --dangerously-skip-permissions

The --dangerously-skip-permissions flag lets the agent call reklawdbox tools without prompting you each time. Without it, you’d need to approve every single tool call, which makes multi-step workflows impractical. This is safe here because reklawdbox never writes to the Rekordbox database — all changes are staged as XML for you to review.

The setup command placed a config file in ~/Music so the tools load automatically there. In other directories, the tools stay out of the way.

For Claude Desktop, the tools load globally — just open a new conversation.

Verify it works

Section titled “Verify it works”

Paste this into your agent:

Show me a summary of my Rekordbox library.

You should see your track count, playlist count, and genre distribution. If something’s wrong, check Troubleshooting.

Discogs authorization

Section titled “Discogs authorization”

Discogs provides labels, catalog numbers, and release metadata that power genre classification. It’s preconfigured — no setup needed.

  1. Ask the agent to look up any track on Discogs. On first use, you’ll get an authorization URL — open it in your browser.

  2. After authorizing, it works automatically from then on.

Manual configuration

Section titled “Manual configuration”

If reklawdbox setup didn’t configure things correctly, or you want to add reklawdbox to other directories, you can set it up manually.

Create a .mcp.json in the directory you want the tools available:

{
  "mcpServers": {
    "reklawdbox": {
      "command": "/opt/homebrew/bin/reklawdbox"
    }
  }
}

If you built from source, use the full path to your binary instead.

After changing config, reload your agent. In Claude Code, run /mcp or start a new conversation. In Claude Desktop, quit and reopen the app.

Next steps

Section titled “Next steps”

Start with Library Cleanup — five sessions that clean your metadata, enrich your tracks, and classify genres. It’s the foundation for everything else.