reaper-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
reaper-mcp
An MCP server that lets Claude (or any MCP client) work inside the REAPER DAW: read the project, edit items and MIDI, set up tracks, routing, FX and automation.
Status: step 3 of 4. Project reading, editing, routing and automation. Render and analysis tools come next.
How it works
Claude ──MCP (stdio)──▶ reaper-mcp (Python) ──JSON files──▶ reaper_mcp_bridge.lua (inside REAPER)The Lua script runs in REAPER's background loop. The Python server drops a request file into
<REAPER resource folder>/reaper_mcp/requests; the script runs it and writes the answer to
.../responses. A heartbeat file tells the server whether the script is running. No ports, no extra
REAPER extensions, works the same on Windows, macOS and Linux.
Related MCP server: reaper-mcp-server
Setup (Windows)
Requires REAPER 7 and Python 3.11+ (or uv).
Install the bridge script into REAPER:
uvx --from git+https://github.com/hubertekvall/reaper-mcp reaper-mcp install-bridgeThis copies
reaper_mcp_bridge.luato%APPDATA%\REAPER\Scripts\reaper_mcp\. For a portable REAPER install, add--resource-path <folder>(REAPER shows it under Options > Show REAPER resource path).In REAPER: Actions > Show action list > New action > Load ReaScript, pick that file, and run it. The console prints
reaper-mcp bridge 0.1.0 running. After updating reaper-mcp, runinstall-bridgeagain and restart the script in REAPER;reaper_statuswarns when REAPER is still running an older bridge.Check the connection:
uvx --from git+https://github.com/hubertekvall/reaper-mcp reaper-mcp doctorAdd the server to Claude Desktop (
%APPDATA%\Claude\claude_desktop_config.json) or Claude Code:{ "mcpServers": { "reaper": { "command": "uvx", "args": ["--from", "git+https://github.com/hubertekvall/reaper-mcp", "reaper-mcp"] } } }Claude Code:
claude mcp add reaper -- uvx --from git+https://github.com/hubertekvall/reaper-mcp reaper-mcp
Tools
Shared conventions: a track is a 0-based index, exact name, GUID or "master". An item is its
GUID or {"track": <track>, "index": <n>}. A time is seconds, {"beats": <quarter notes>} or
{"bar": 5, "beat": 1}. Every editing tool is one undo step in REAPER.
Area | Tools |
Project |
|
Tracks |
|
Items |
|
MIDI |
|
FX |
|
Transport |
|
Markers |
|
Routing |
|
Automation |
|
Anything else |
|
REAPER objects travel as references such as {"$type": "MediaTrack", "index": 0},
{"$type": "MediaItem", "guid": "{...}"} or {"$type": "MediaTrack", "master": true}.
Settings
Variable | Default |
|
|
|
|
Development
uv sync
uv run pytestThe tests load the real Lua bridge into Lua 5.4 (via Lupa) with a small fake of the ReaScript API, so the file transport, JSON handling and commands are exercised without REAPER.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Remote MCP server for audio stem separation, denoise, reverb, and MIDI export.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server for Producer/Riffusion AI music generation
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseCqualityAmaintenanceA comprehensive MCP server that enables AI assistants to control REAPER DAW for mixing, mastering, MIDI composition, and full music production workflows with 130 tools.1871,166 PyPI114MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that lets language models interact with the Reaper DAW1MIT
- FlicenseAqualityDmaintenanceAn MCP server that gives Claude Code (or any MCP client) full control of Reaper.531-
- AlicenseBqualityDmaintenanceThis MCP server enables AI assistants to control a live REAPER DAW instance, including transport, tracks, FX, MIDI, media, markers, rendering, and project state, with an escape hatch for arbitrary ReaScript commands.40MIT