Skip to content
Back to search

reaper-mcp

MCP server for Reaper

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hubertekvall--reaper-mcp/badge.svg)](/listings/hubertekvall--reaper-mcp)

HTML

<a href="/listings/hubertekvall--reaper-mcp"><img src="/api/listings/hubertekvall--reaper-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires REAPER 7 and Python 3.11+ (or [uv](https://docs.astral.sh/uv/)).

1. Install the bridge script into REAPER and have it start with REAPER:

   uvx --from git+https://github.com/hubertekvall/reaper-mcp reaper-mcp install-bridge --autostart

This copies `reaper_mcp_bridge.lua` to `%APPDATA%\REAPER\Scripts\reaper_mcp\` and adds a small, clearly marked block to `Scripts\__startup.lua` that runs it whenever REAPER starts (your own startup code is kept; `--no-autostart` removes the block again). For a portable REAPER install, add `--resource-path <folder>` (REAPER shows it under *Options > Show REAPER resource path*). 2. Restart REAPER. The console prints `reaper-mcp bridge 0.3.1 running`. Without `--autostart`, load and run the script yourself: *Actions > Show action list > New action > Load ReaScript*. After updating reaper-mcp, run `install-bridge` again and restart REAPER (or the script); `reaper_status` warns when REAPER is still running an older bridge. 3. Check the connection:

   uvx --from git+https://github.com/hubertekvall/reaper-mcp reaper-mcp doctor

4. Add 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`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 93 lines
  1. # reaper-mcp
  2. An [MCP](https://modelcontextprotocol.io) server that lets Claude (or any MCP client) work inside the
  3. [REAPER](https://www.reaper.fm) DAW: read the project, edit items and MIDI, set up tracks, routing,
  4. FX and automation.
  5. > **Status: all 4 steps done.** Project reading, editing, routing, automation, rendering and audio
  6. > analysis, with a one-command install that starts the bridge with REAPER.
  7. ## How it works
  8. ```
  9. Claude ──MCP (stdio)──▶ reaper-mcp (Python) ──JSON files──▶ reaper_mcp_bridge.lua (inside REAPER)
  10. ```
  11. The Lua script runs in REAPER's background loop. The Python server drops a request file into
  12. `<REAPER resource folder>/reaper_mcp/requests`; the script runs it and writes the answer to
  13. `.../responses`. A heartbeat file tells the server whether the script is running. No ports, no extra
  14. REAPER extensions, works the same on Windows, macOS and Linux.
  15. ## Setup (Windows)
  16. Requires REAPER 7 and Python 3.11+ (or [uv](https://docs.astral.sh/uv/)).
  17. 1. Install the bridge script into REAPER and have it start with REAPER:
  18. ```
  19. uvx --from git+https://github.com/hubertekvall/reaper-mcp reaper-mcp install-bridge --autostart
  20. ```
  21. This copies `reaper_mcp_bridge.lua` to `%APPDATA%\REAPER\Scripts\reaper_mcp\` and adds a small,
  22. clearly marked block to `Scripts\__startup.lua` that runs it whenever REAPER starts (your own
  23. startup code is kept; `--no-autostart` removes the block again). For a portable REAPER install,
  24. add `--resource-path <folder>` (REAPER shows it under *Options > Show REAPER resource path*).
  25. 2. Restart REAPER. The console prints `reaper-mcp bridge 0.3.1 running`. Without `--autostart`,
  26. load and run the script yourself: *Actions > Show action list > New action > Load ReaScript*.
  27. After updating reaper-mcp, run `install-bridge` again and restart REAPER (or the script);
  28. `reaper_status` warns when REAPER is still running an older bridge.
  29. 3. Check the connection:
  30. ```
  31. uvx --from git+https://github.com/hubertekvall/reaper-mcp reaper-mcp doctor
  32. ```
  33. 4. Add the server to Claude Desktop (`%APPDATA%\Claude\claude_desktop_config.json`) or Claude Code:
  34. ```json
  35. {
  36. "mcpServers": {
  37. "reaper": {
  38. "command": "uvx",
  39. "args": ["--from", "git+https://github.com/hubertekvall/reaper-mcp", "reaper-mcp"]
  40. }
  41. }
  42. }
  43. ```
  44. Claude Code: `claude mcp add reaper -- uvx --from git+https://github.com/hubertekvall/reaper-mcp reaper-mcp`
  45. ## Tools
  46. Shared conventions: a **track** is a 0-based index, exact name, GUID or `"master"`. An **item** is its
  47. GUID or `{"track": <track>, "index": <n>}`. A **time** is seconds, `{"beats": <quarter notes>}` or
  48. `{"bar": 5, "beat": 1}`. Every editing tool is one undo step in REAPER.
  49. | Area | Tools |
  50. | --- | --- |
  51. | Project | `reaper_status`, `get_project_state` (also the `reaper://project` resource) |
  52. | Tracks | `create_track`, `update_track` (name, volume, pan, mute, solo, phase, color, folder depth, move), `delete_tracks`, `create_folder`, `setup_recording` (input, monitoring, record mode, arm), `create_instrument_track` |
  53. | Items | `edit_item` (move, trim, change track, fades, volume, pitch, rate, lock, name), `split_item`, `delete_items`, `reverse_items`, `glue_items`, `duplicate_item`, `insert_media_file` |
  54. | MIDI | `create_midi_item`, `get_midi`, `add_midi_notes`, `delete_midi_notes`, `add_midi_cc` (CC, pitch bend, program change) |
  55. | FX | `list_installed_fx`, `add_fx`, `remove_fx`, `update_fx` (bypass, offline, preset, reorder), `get_fx_params`, `set_fx_params` (normalized, or by the value the plug-in displays, such as `-6` dB) |
  56. | Transport | `transport` (play, stop, pause, record, go to), `set_time_selection`, `set_tempo` |
  57. | Markers | `add_marker` (markers and regions), `update_marker`, `delete_marker` |
  58. | Routing | `create_send`, `update_send` (level, pan, mute, pre/post, channels, MIDI, remove), `create_fx_return` (reverb/delay/parallel bus fed by sends), `create_sidechain` (into channels 3/4, sets the detector input where possible). Folder buses: `create_folder`. |
  59. | Automation | `write_automation` (points with curve shapes, optionally as an automation item), `draw_automation` (ramps and sine/triangle/square/saw LFOs synced to beats), `get_automation`, `clear_automation`. Targets: volume, pan, width, mute, trim, or any FX parameter. Track automation mode via `update_track`. |
  60. | Render and listen | `render` (master mix or one file per track, any time range, 24-bit WAV; your own render settings and track selection are restored) with a built-in analysis, and `analyze_audio_file` for any WAV such as a reference track. The analysis reports integrated, short-term and momentary loudness (EBU R128 / BS.1770), loudness range, sample and true peak, RMS, crest factor, clipping, DC offset, stereo correlation, width and balance, and energy per band from sub to air. |
  61. | Anything else | `call_reaper_api`: any [ReaScript function](https://www.reaper.fm/sdk/reascript/reascripthelp.html), with optional undo |
  62. REAPER objects travel as references such as `{"$type": "MediaTrack", "index": 0}`,
  63. `{"$type": "MediaItem", "guid": "{...}"}` or `{"$type": "MediaTrack", "master": true}`.
  64. ## Settings
  65. | Variable | Default |
  66. | --- | --- |
  67. | `REAPER_RESOURCE_PATH` | `%APPDATA%\REAPER` (Windows), `~/Library/Application Support/REAPER` (macOS), `~/.config/REAPER` (Linux) |
  68. | `REAPER_MCP_BRIDGE_DIR` | `<resource path>/reaper_mcp` |
  69. ## Development
  70. ```
  71. uv sync
  72. uv run pytest
  73. ```
  74. The tests load the real Lua bridge into Lua 5.4 (via [Lupa](https://github.com/scoder/lupa)) with
  75. a small fake of the ReaScript API, so the file transport, JSON handling and commands are exercised
  76. without REAPER.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.