ReaperMCP

by xdarkzx

Not rated
GitHub

About

AI-powered music production in REAPER via the Model Context Protocol — 150 tools for composition, mixing, mastering, and audio analysis.

Details

Author
xdarkzx
Categories
Productivity, Other, Media

Setup

Install ReaperMCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/xdarkzx/Reaper-MCP

Follow the installation instructions in the repository README, then restart your MCP client.

AI-powered music production in REAPER through the Model Context Protocol

Quick Start•Why ReaperMCP?•Features•Tools Reference•Architecture•Changelog•Contributing•Troubleshooting

ReaperMCP connects any MCP-compatible AI assistant toREAPER, giving it full control over music production. Talk to your AI assistant and it composes, mixes, masters, andmeasuresyour music in real-time — the AI chooses every note, rhythm, and CC itself.

180 tools across 26 modulescover the full workflow: MIDI composition and patterns, a vocal-chop pipeline, FX and automatic genre-tuned mixing/mastering (35 style profiles), sends and routing, and post-production QC — batch editing, ReaScript automation, silence/click detection.

No cloud. Nothing leaves your machine.ReaperMCP runs entirely locally through a file-based Lua IPC bridge inside REAPER — your project, audio, and MIDI stay on your computer. Bring whatever AI client you already use (Claude Desktop, Claude Code, Cursor, any MCP client) — ReaperMCP handles REAPER.

If this is useful to you, a star helps other people find it— that's the whole marketing budget for this project. Want to help keep it maintained? Click theSponsorbadge up top.

ReaperMCP works with any AI client that supports theModel Context Protocol:

- Claude Desktop— Anthropic's desktop app
-
Claude Code— CLI agent
-
Cursor— AI code editor with MCP support
-
LM Studio— run local models with MCP tool access
- Any other
MCP-compatible client

- Deep control, not just playback.Most AI-audio integrations expose basic transport — play, stop, record. ReaperMCP exposes REAPER's actual production surface: genre-aware automatic mixing/mastering across 35 style profiles, a vocal-chop pipeline, drum-pattern and chord-progression shorthand, and post-production QC. The AI can produce a track end-to-end, not just push buttons on one you already made.
- 100% local.No cloud calls, no API keys, nothing leaves your machine — REAPER and the AI talk over a file-based bridge on disk, not a server you don't control.
- Actively maintained.CI runs the full test suite across 3 OS × 4 Python versions on every change. Issues get read, discussed, and shipped — not just filed and forgotten.
- Composable with companion tools.Pairs with
SongForge-MCP(local AI music/vocal generation) andAudacity-MCP(audio cleanup, mastering, and local transcription) — generate, produce, and clean up without leaving the same AI conversation.

Option A:Click the greenCodebutton above →Download ZIP→ extract to a folder — works with nothing pre-installed, easiest on a brand new machine.

Option B:Clone with git (lets yougit pullfor updates later):

A fresh Windows install doesn't ship with git — check first:

If that says "not recognized", install it, then close and reopen your terminal:

winget install --id Git.Git -e --source winget

(wingetitself ships with Windows 11 and up-to-date Windows 10. Ifwingetisn't found either, grab the installer directly fromgit-scm.com.)

macOS/Linux almost always have git already —git --versionto check, orbrew install git/sudo apt install gitif not.

git clone https://github.com/xDarkzx/Reaper-MCP.git

Option C:Already have Python? Install the published package straight from PyPI:

This gives you thereaper-mcpcommand directly — but you'll still needreaper_scripts/reaper_mcp_server.luafor Step 3 below, since that one file isn't bundled into the PyPI package (grab it from the repo, ordownload it directly).

Windows:either double-clickinstall.batin File Explorer, or — if you're already in a terminal from thegit clonestep above — just keep going in the same PowerShell/Command Prompt window:

The installer installsreaper-mcplocally and optionallyconfigures Claude Desktop— no manual JSON editing needed.

Install manually withpip install -e .from the repo folder (orpip install xdarkzx-reaper-mcpfrom PyPI) and add to your client's MCP config:

{ "mcpServers": { "reaper": { "command": "reaper-mcp" } } }

Check your client's MCP documentation for the config file location.

Used the one-click installer?Already done — it sets up REAPER to auto-load the script on every launch. Just open (or restart) REAPER.
- OpenREAPER
- Go toActions → Show action list
- ClickLoad ReaScript...
- Navigate toreaper_scripts/reaper_mcp_server.luaand select it
- ClickRun

This only loads it for the current session — you'll need to re-run it each time REAPER restarts. Seedocs/INSTALLATION.mdfor the auto-start setup.

"Create 4 tracks: strings, brass, piano, and drums" "Compose an 8-bar orchestral string arrangement in D minor" "Add ReaEQ to the piano track and cut the low end below 200Hz" "Set the tempo to 90 BPM and loop the first 8 bars"

REAPER must be open with the Lua script running.ReaperMCP communicates through file-based IPC — it can't launch REAPER for you.

See the fullInstallation Guidefor detailed setup on all platforms and MCP clients.

See[docs/TOOLS.mdfor the complete tool reference with every signature and a one-line description for each tool.

The default 180-tool surface is designed for full-featured frontier models. Smaller/cheaper models (Groq Llama 3 caps at 128 tools, some local models lower still) will silently truncate. SetREAPER_MCP_PROFILEin your client's server config to pick a workflow-specific subset:

{ "mcpServers": { "reaper": { "command": "reaper-mcp", "env": { "REAPER_MCP_PROFILE": "mixing" } } } }

35 professional style profiles drive automatic EQ, compression, reverb buses, sidechain pumping, and mastering — each tuned to industry-standard LUFS targets and character.

- EDM (11):melodic_dubstep,big_room,future_bass,future_house,deep_house,tech_house,progressive_house,dubstep,trap,drum_and_bass,trance
- Rock (6):alt_rock,classic_rock,pop_rock,hard_rock,punk,post_rock
- Pop (4):modern_pop,dance_pop,indie_pop,rnb_pop
- Electronic (4):synthwave,lofi,ambient,hiphop
- Jazz (3):swing_jazz,jazz_fusion,latin_jazz
- Orchestral (3):classical_chamber,cinematic_trailer,ambient_orchestral
- Funk/Soul (4):classic_funk,motown_soul,neo_soul,disco_funk

Smart plugin detection.fx_list_installed()inspects what's on the user's machine and reports the best-available EQ / compressor / reverb / limiter / de-esser / gate / saturator / multiband / stereo tool — covering FabFilter, Waves, iZotope, Valhalla, Softube, TDR, Slate, Melda, Soundtoys, Airwindows, REAPER stock, and common rack hosts (Waves StudioRack, Blue Cat PatchWork, Kilohearts Snap Heap). Users can pin category → plugin preferences viaset_fx_preferences(...).

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.