REAPER MCP Skills Example

About

MCP server for controlling REAPER DAW through Python scripts. It communicates with the lua server from ReaScript-Socket-Example - run api_server.lua in REAPER to establish the connection.

TL;DR: This enables AI to generate Python code that uses MCP to call Lua-style ReaScript APIs, executing Lua ReaScript commands in REAPER. This approach combines Python's versatility with the popularity of Lua ReaScript APIs.

Example usage

1. Create tracks

1. Set track colors in a cycle loop

Running

This project runs with uv Python. Start the server:

# In the project directory
uv run reaper_mcp

# Or with directory path
uv run --directory /path/to/reaper_mcp reaper_mcp

To run MCP in agent programs such as OpenCode, you need to edit the configuration file. For example:

"reaper": {
  "type": "local",
  "enabled": false,
  "command": [
    "uv",
    "run",
    "--directory",
    "/path",
    "reaper_mcp"
  ]
}

The configuration varies for different programs.

SKILLS Directory

The SKILLS/ directory contains skill definition files for REAPER operations. These files are written in Chinese (my native language is Chinese) and provide instructions for specialized REAPER tasks. I believe the translated English versions would have the same effectiveness.

To use these skills, copy them to the corresponding directory of your software. For example, with OpenCode:

cp -r SKILLS/* ~/.opencode/skills/

Available Skills

• reaper-track - Track operations and management (create, edit, configure, traverse, statistics, color)
• reaper-color - Color operations (RGB conversion to REAPER system colors)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: wastee
• Source: wastee/REAPER-MCP-Skills-Example
• License: MIT

Install and usage instructions live in the source repository linked above.