Doricomcp

doricomcp

Talk to your Dorico score. doricomcp connects Claude to a live Dorico 6 project, so you can ask about the music and have it edited for you:

• "What is in bars 12-20 of the violas?"
• "Add a crescendo from bar 40 beat 2 to the downbeat of 42 in all strings."
• "Put pizz. on the cellos in bar 33 and arco in bar 37."
• "Double the violin line an octave lower in the violas."
• "Check the voice leading in bars 20-28 against this chord plan."

Every edit appears in Dorico as one ordinary undo step, and it is read back and checked; if the check fails, the edit is undone at once. doricomcp uses only Dorico's own interfaces (Remote Control and its built-in Lua scripting): it does not modify Dorico or your files.

Not affiliated with or endorsed by Steinberg.

Dorico is a trademark of Steinberg Media Technologies GmbH.

Status: alpha, tested on Dorico 6.2.30 on macOS.

Save your work before a session.

Install

You need a Mac with Dorico 6.2 or later and Claude Desktop or Claude Code.

1. Turn on Remote Control in Dorico. In Dorico's Preferences, enable Remote Control and keep the port at 4560.
2. Add doricomcp to Claude, one of:

• Claude Desktop: download doricomcp.mcpb from the latest release and double-click it, then click Install. Claude sets up Python by itself.
• Claude Code: install uv, then run claude mcp add doricomcp -- uvx doricomcp.
• Any other MCP client: install uv and add this server to the client's configuration:

json { "mcpServers": { "doricomcp": { "command": "uvx", "args": ["doricomcp"] } } }

If the client cannot find uvx, use its full path (which uvx in Terminal; usually /opt/homebrew/bin/uvx or ~/.local/bin/uvx).

1. Open a score in Dorico and ask Claude something about it. The first time, Dorico asks whether to allow the client doricomcp: click Allow. You will not be asked again.
2. Optional: to let Claude look at the score (screenshot) and answer Dorico's dialogs, allow Screen Recording and Accessibility for Claude in System Settings > Privacy & Security. Both need the Xcode Command Line Tools (xcode-select --install).

Troubleshooting

• "Dorico is not reachable": Dorico is not running, or Remote Control is off or on another port.
• Dorico never shows the approval prompt: delete ~/.doricomcp/session_token and ask again.
• Some tools are switched off in Claude Desktop: Claude Desktop remembers switched-off tools per server name; switch them on in the server's settings.
• Anything else: open an issue with what you asked and what happened.

How to talk about the music

Claude handles these details for you; they matter when you read the tool results.

• Positions are a bar (1-based) and a beat, counted in crotchets from the start of the bar (0, 1, 3/2), or a position in crotchets from the start of the flow.
• Voices are numbered per score (piano: 2 = right hand, 4 = left hand); get_score_overview lists them with their instrument, staff and voice.
• Notes are written like "Eb4+G4+C5:h. G4:e Eb5:q. C5:s r:q": C4 is middle C, durations are note values w h q e s t with dots, or crotchets (3/2).
• Dynamics, tempo, time signatures, clefs, ornaments and holds take the same text as Dorico's popovers (p pp, rit., [2+2+3]/8). The popover guide lists every entry and what Dorico 6.2 actually creates for the undocumented ones.
• Playing techniques are given by name (pizz., con sord.), including ones you added to the score yourself.

What it can do

"Confirmed live" means the test harness ran the tool on a real Dorico and read the result back.

Session & introspection

Read

Write: notes

Write: markings

| add_rehearsal_mark | A rehearsal mark (next letter in sequence) at the start of a ba