Skip to content
Back to search

reaper-mcp

A comprehensive Model Context Protocol (MCP) server that enables AI agents to create fully mixed and mastered tracks in REAPER with both MIDI and audio capabilities.

Safety scan

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

Checked today
Badge for your README
findsafeskills safety rating

Markdown

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

HTML

<a href="/listings/bonfire-systems--reaper-mcp"><img src="/api/listings/bonfire-systems--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.

pip install reaper-mcp-server

Or install from source:

git clone https://github.com/bonfire-systems/reaper-mcp.git
cd reaper-mcp
pip install -e .

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 · 110 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # REAPER MCP Server
  2. A Model Context Protocol (MCP) server that enables AI agents to control REAPER DAW — 61 tools covering project management, tracks, track templates, MIDI, FX, mixing, mastering, rendering, and audio analysis.
  3. ## Requirements
  4. - [REAPER](https://www.reaper.fm/) 7 or later, installed and running
  5. - Python 3.10+
  6. - REAPER's distant API enabled (see [Setup](#setting-up-reaper))
  7. ## Installation
  8. ```bash
  9. pip install reaper-mcp-server
  10. ```
  11. Or install from source:
  12. ```bash
  13. git clone https://github.com/bonfire-systems/reaper-mcp.git
  14. cd reaper-mcp
  15. pip install -e .
  16. ```
  17. ## Setting Up REAPER
  18. The server communicates with REAPER via [python-reapy](https://github.com/RomeoDespres/reapy), which requires REAPER's distant API to be enabled.
  19. 1. Open REAPER
  20. 2. Go to Actions > Run ReaScript
  21. 3. Select `scripts/enable_reapy.py` from this repo (or create a new script with the contents below)
  22. ```python
  23. import reapy
  24. reapy.config.enable_dist_api()
  25. ```
  26. 4. Restart REAPER
  27. ## Usage
  28. ### With Claude Desktop
  29. Add to your Claude Desktop config (`claude_desktop_config.json`):
  30. ```json
  31. {
  32. "mcpServers": {
  33. "reaper": {
  34. "command": "reaper-mcp-server",
  35. "args": []
  36. }
  37. }
  38. }
  39. ```
  40. ### With Claude Code
  41. ```bash
  42. claude mcp add reaper -- reaper-mcp-server
  43. ```
  44. ### Standalone
  45. ```bash
  46. reaper-mcp-server # start the server
  47. reaper-mcp-server --debug # with debug logging
  48. ```
  49. ## Tools (60)
  50. ### Project Management
  51. `create_project` `load_project` `save_project` `get_project_info` `set_tempo` `set_time_signature` `set_cursor_position` `play_project` `stop_transport`
  52. ### Tracks
  53. `create_track` `delete_track` `rename_track` `list_tracks` `get_track_info` `set_track_color` `create_bus` `create_send` `remove_send` `list_sends`
  54. ### Track Templates
  55. `list_track_templates` `insert_track_template`
  56. Inserts saved `.RTrackTemplate` files from REAPER's TrackTemplates folder (subfolders included) with their exact FX state, routing, folder structure and items, optionally at a given track position.
  57. ### MIDI
  58. `create_midi_item` `add_midi_note` `create_chord_progression` `create_drum_pattern`
  59. ### FX & Instruments
  60. `add_fx` `remove_fx` `bypass_fx` `list_track_fx` `get_fx_parameters` `set_fx_parameter` `load_fx_preset` `add_master_fx` `list_master_fx` `set_master_fx_parameter`
  61. ### Audio
  62. `import_audio_file` `edit_audio_item` `start_recording` `adjust_pitch` `adjust_playback_rate`
  63. ### Mixing
  64. `set_track_volume` `set_track_pan` `set_track_mute` `set_track_solo` `set_send_volume` `set_master_volume` `add_volume_automation` `add_pan_automation`
  65. ### Rendering
  66. `render_project` `render_stems` `render_time_selection` `render_regions`
  67. ### Mastering
  68. `apply_mastering_chain` `apply_limiter` `normalize_project`
  69. ### Analysis
  70. `analyze_loudness` `analyze_dynamics` `analyze_frequency_spectrum` `analyze_stereo_field` `analyze_transients` `detect_clipping`
  71. ## Contributing
  72. See [CONTRIBUTING.md](CONTRIBUTING.md). In short: one concern per pull request,
  73. tested against a real REAPER (say which version), and an issue first for new
  74. tools.
  75. ## License
  76. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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