doricomcp
Connects to a live Dorico 6 score, Steinberg's notation software, via Dorico Remote Control and built-in Lua scripting. It enables reading and editing music in the open project, including notes, chords, rests, dynamics, hairpins, articulations, playing techniques, voices, tuplets, clefs, tempo, text, and voice-leading checks, with each edit applied as an undoable and verified operation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@doricomcp add a crescendo from bar 40 beat 2 to the downbeat of 42 in all strings"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
Turn on Remote Control in Dorico. In Dorico's Preferences, enable Remote Control and keep the port at 4560.
Add doricomcp to Claude, one of:
Claude Desktop: download
doricomcp.mcpbfrom 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:
{ "mcpServers": { "doricomcp": { "command": "uvx", "args": ["doricomcp"] } } }If the client cannot find
uvx, use its full path (which uvxin Terminal; usually/opt/homebrew/bin/uvxor~/.local/bin/uvx).
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.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_tokenand 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.
Related MCP server: ableton-mcp
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_overviewlists 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 valuesw h q e s twith dots, or crotchets (3/2).Quarter-tones (in a score whose tonality system is 24-EDO, set in Dorico's Key Signatures panel) are spelled as Dorico spells them: the alteration as a fraction of an octave between the letter and the octave.
A1/244is A4 a quarter-tone sharp,C-1/245is C5 a quarter-tone flat,D1/85is D5 three quarter-tones sharp (3/24 = 1/8).Dynamics, tempo, time signatures, clefs, ornaments and holds take the same text as Dorico's popovers (
p<f,pp<ff>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
Tool | What it does | Status |
| Live Dorico status (mode, selection, note input, undo availability) from Remote Control. | read-only |
| The confirmation matrix: every capability, its mechanism and whether the live harness confirmed it. | read-only |
| Search Dorico's 1,200 commands (regex on name/display name) with their parameters and enum values. | read-only |
| Exact accepted values of a Dorico enum type (or regex over enum type names). | read-only |
| Type, display name and enum values of an event property (e.g. kNoteVelocity, kEventColour). | read-only |
| Library entities (ids + names), live from Dorico: kInstrumentCollection, kClefCollection, kPlayingTechniqueAppearanceCollection ... | read-only |
| Escape hatch: run any catalogued Dorico command ("Namespace.Command?Param=value&..."), validated against the catalogue. | confirmed live |
| A picture of Dorico's score window, to check engraving by eye. | confirmed live |
| Dorico's open dialogs (every window other than a project window): title, modal, the texts shown and the controls (role, title or label ... | confirmed live |
| Press a control in a Dorico dialog: a button ("OK", "Cancel", "Apply", "Close"), checkbox, radio button or tab, by its title, the label ... | confirmed live |
| Set a control in a Dorico dialog: a checkbox or radio button to true/false, a text field to text, a pop-up or combo box to one of its items ... | confirmed live |
| Forget cached reads (time signatures, dynamics, keys, structure); use after editing in Dorico by hand. | read-only |
Read
Tool | What it does | Status |
| Players, instruments, layouts and flows; per flow its streams and voices (voice-stream id -> instrument, staff index, voice index). | confirmed live |
| Bar numbers <-> positions, time signatures (read by Dorico's own equality API, cached) and optionally key signatures (include_keys: a ... | confirmed live |
| Notes, chords, rests (explicit and implicit), grace notes, tuplets, slurs and articulations per voice, with exact positions, durations ... | confirmed live |
| Dynamics (levels incl. sfz/rfz/fz, hairpins), slurs, clefs, ottavas, text, tempo (text, bpm), holds, rehearsal marks, repeats, breaks ... | confirmed live |
| What is in force at a point: time signature, key signature, clef, dynamic level (and a hairpin running through the point), ottava, the last ... | confirmed live |
| Voice-leading check of the score: parallel and contrary fifths/octaves/unisons, hidden fifths/octaves in the outer voices, crossings ... | confirmed live |
| What changed in a flow: without since, take a snapshot and return its token; with since=, list the events added, removed and changed ... | confirmed live |
| The current selection in Dorico (event type and, if available, its properties). | read-only |
| House-style options: kind kEngraving (per score), kNotation (per flow: flow_id), kLayout (per layout: layout_id). | read-only |
Write: notes
Tool | What it does | Status |
| Write notes, chords and rests one after another from a position. | confirmed live |
| Delete the notes, rests, grace notes and tuplets of a voice in a range (bars inclusive, or positions [from_pos, to_pos)); slurs, text and ... | confirmed live |
| Delete events by id: notes, rests or markings (dynamics, hairpins, slurs, text, clefs, octave lines...). | confirmed live |
| Change one note's pitch and spelling (e.g. "F#4", "Ebb5") in place: it keeps its id, rhythm, slurs and articulations. | confirmed live |
| Change a note's or rest's duration (crotchets or w h q e s t with dots). | confirmed live |
| Apply an edit to notes: pitch_up/pitch_down (diatonic steps x count), chromatic_up/down, octave_up/down, respell_above/below ... | confirmed live |
| Add a note at an interval to each given note, making a chord: "3" (third above), "-3", "maj3", "min6 below", "p5", "octave". | confirmed live |
| Add a grace note before the note at the given position (value: notated length, default quaver). | confirmed live |
| Copy (or move) notes and rests of a range to another place or voice/staff (markings are not copied). | confirmed live |
| A tuplet typed with Dorico's note input, overwriting what is there: ratio "3:2", "5:4"; unit = the tuplet's note value (e, q, s, h); notes ... | confirmed live |
| Exchange the notes and rests of two voices in a range (e.g. divisi lines trading places), one undo step. | confirmed live |
| Start a new voice on the same staff as | confirmed live |
Write: markings
Tool | What it does | Status |
| staccato, staccatissimo, tenuto, accent, marcato, stress, unstress, staccato_tenuto on notes. | confirmed live |
| A line from one note to another in the same voice: slur, cresc, dim, messa_di_voce (hairpins), 8va, 8vb, 15ma, 15mb (octave lines) ... | confirmed live |
| A hairpin (cresc, dim, messa_di_voce) from one position to another, e.g. bar 33 beat 0 to bar 33 beat 3/2, wherever notes start (also ... | confirmed live |
| An immediate dynamic (p, pp, mp, mf, f, ff, sfz, fp, ...) on the voice's instrument at a position, also where no note starts (inside a held ... | confirmed live |
| kind=ornament (value tr, mordent, inv, turn), hold (fermata, breath, caesura...), playing_technique (value: a name like pizz., arco, con ... | confirmed live |
| Staff text (e.g. "dolce", "espress.") attached to a voice at a position. | confirmed live |
| A clef change on the voice's staff: clef.treble, clef.bass, clef.alto, clef.tenor, clef.treble8ba . | confirmed live |
| A tempo marking: "q=120", "Allegro q=132", "h.=60", "rit.", "a tempo". | confirmed live |
| Time signature from a bar on: 3/4, 6/8, 2+3/8, c, cut. | confirmed live |
| Key signature from a bar on: "2#", "3b", "0", or names like "Eb", "F#m", "c minor". | confirmed live |
| Barline at the start of a bar: "||" double, "|:" start repeat, ":|" end repeat, ":|:", "|||" final, ":" dashed. | confirmed live |
| segno, coda, fine, "to coda", "D.C.", "D.C. | confirmed live |
| A rehearsal mark (next letter in sequence) at the start of a bar. | confirmed live |
| Force a system or frame (page) break before a bar. | confirmed live |
| Set any event property (all layouts), e.g. kNoteVelocity=100, kEventColour=#ffff0000, kEventScale=kCue, kNoteForcedVoiceDirection. | confirmed live |
Write: options & structure
Tool | What it does | Status |
| Set a house-style option (paths and values from get_options). | confirmed live |
| Add a solo (or section) player holding an instrument from the library, e.g. instrument.strings.violin, instrument.wind.flute (list_library ... | confirmed live |
| Give an existing player (index in get_score_overview players) an extra instrument (doubling). | confirmed live |
| Rename a player (index in get_score_overview players). | confirmed live |
| Add a new flow (movement) at the end of the project, with all players. | confirmed live |
| Rename a flow (ids from get_score_overview flows). | confirmed live |
| Delete a flow and all its music (one undo step; undo restores it). | confirmed live |
| Remove an instrument and all its music (one undo step; undo restores it). | confirmed live |
| Add a custom score layout (optionally named). | confirmed live |
| Rename a layout (ids from get_score_overview layouts). | confirmed live |
| Include or exclude flows in a layout (Dorico does not expose a layout's flows for read-back). | confirmed live |
| Instrument order template, e.g. instrumentscoreorder.orchestral, instrumentscoreorder.windband, instrumentscoreorder.choral (list_library ... | confirmed live |
Navigation, playback, history
Tool | What it does | Status |
| Scroll Dorico's view to a bar. | confirmed live |
| Select an event in Dorico (e.g. to show the user). | confirmed live |
| Start playback (from a bar, or from the playhead). | confirmed live |
| Stop playback. | confirmed live |
| Undo the last | confirmed live |
| Redo | confirmed live |
Known gaps and how they could be closed
What follows is what Dorico's interfaces do not give yet, measured on 6.2.30, with the most promising way in. Each one is a good first contribution.
Lyrics (
read_markings, no write tool). Lyric text is not readable andNoteInput.StartLyricInputplusAcceptCurrentLyricInput?LyricText=from a script created no lyric. Next: send the same two commands from Remote Control (not Lua) with the note selected, and try theEventCreationLocationparameter; then read the lyric back with the selection read used for tempo.Tempo beat unit (
read_markings,read_context_at). Text, bpm, relative and final percentages are read by selecting the tempo marking, but the beat unit is never exposed, soh.=60andq=60both read 60. Next: record the definition whenset_tempowrites it (asadd_voicerecords staves), and compare against Dorico's playback tempo for markings made by hand.fp and sffz (
read_markings). sfz, sf, rfz, rf, fz and mfz are read from the dynamic's force type; fp leaves no readable property and sffz reads as sfz. Next: extend the sealed-value equality probe that reads p/f levels to Dorico-built fp and sffz candidates.Note details in voices with techniques, trills, ornaments, arpeggios or glissandi (
read_music). Lua cannot list events in such a voice, so pitches and rhythms come from the stream dump, but articulations and ties do not. Measured route: in one script, delete the voice's technique, trill or ornament events, read the notes with all their properties, then undo at once; the voice dump came back identical. For a single note, Remote Control'sstatusmessage carries the selected note's articulation flags (articulationStaccato, ...).div. and unis. (
add_text). They are written as staff text; Dorico's real divisi isEdit.AddDivisi/Edit.RestoreUnison, which open the Change Divisi dialog. Next: drive that dialog with the existing dialog tools, asdelete_flowdoes with its confirmation.Tonality system (24-EDO and others). Quarter-tones are read and written, but switching a score to 24-EDO is only in Dorico's Key Signatures panel: the keys popover rejects a tonality system in its text, and
CreateKeySignatureignores atonalitySystemIDparameter. Next: look for the panel's command in Remote Control's command list after choosing a system there by hand.Deleting players (
remove_instrumentremoves instruments).Project.Players.Deleteneeds a player selected in Setup mode, andProject.Players.DeleteEmptyopens a dialog listing every player without music, not just one. Next: select the one player in that dialog withdialog_setbefore pressing Delete Selected Players.Copy and move with markings (
copy_range). Lua'scopyRangeis a no-op, so notes and rests are re-created and markings are not copied. Next: re-create slurs, dynamics and articulations from the twin, asadd_notes(replace=True)already does for slurs.Key tonic and mode (
get_bar_map). Only the signature (e.g. 2 sharps) is recoverable. Next: infer major/minor from the music withcheck_voice_leading's chord logic and present it as a guess.Title and composer (
get_score_overview). Not in Lua or Remote Control. No route known through Dorico's own interfaces.Staff of a voice (
get_score_overview). Dorico does not say which staff a voice is on; the server knows the first voice per staff and the voices it created, and says "unknown" otherwise.Redo after a read (
redo). Any script, even a read, clears Dorico's redo stack, so redo works only directly after undo.
How writes stay safe
Every write is one Lua transaction, which Dorico records as one undo step.
The tool reads the affected range back and checks the expected result; on a mismatch it undoes the step immediately and confirms the range is restored.
A script is never abandoned: Dorico runs Remote Control commands in between a script's own commands, so a read or undo sent while a script still runs would land in the middle of it. The bridge waits for the script's done marker however long it takes; it stops early only for a modal dialog, and then nothing is undone.
A tool call the client cancels still runs to the end under the session lock (verified, or undone on failure), and the next tool result reports how it ended.
Commands that act on "the selection" always get a real selection first (an event at the position, or a temporary rest deleted in the same step), because a selection-less popover command can open a modal dialog that blocks Dorico.
Reading a tempo selects it, and Dorico records every selection as an undo step; the server counts the selection steps its reads leave on top and
undoskips them.
Contributing
Bug reports, measurements on other Dorico versions and pull requests are welcome. CONTRIBUTING.md explains the layout, the checks and how to run the live test harness. What Dorico does and does not allow through its interfaces is recorded in docs/dorico-behaviour.md.
Roadmap
Close the gaps listed above, starting with lyrics and note details in technique voices.
Windows support: the Remote Control and Lua parts are portable; screenshots and dialogs need a Windows counterpart of
windows.py.Milestone: a project website on GitHub Pages with setup, a demo video and the tool reference.
License
MIT, see LICENSE.
Available Tools
66 toolsadd_articulationC
staccato, staccatissimo, tenuto, accent, marcato, stress, unstress, staccato_tenuto on notes.
Inputs: kind (required), event_ids (required), flow.
add_barlineC
Barline at the start of a bar: "||" double, "|:" start repeat, ":|" end repeat, ":|:", "|||" final, ":" dashed.
Inputs: bar (required), kind (required), flow.
add_breakC
Force a system or frame (page) break before a bar.
Inputs: bar (required), flow, kind.
add_clefD
A clef change on the voice's staff: clef.treble, clef.bass, clef.alto, clef.tenor, clef.treble8ba ...
Inputs: clef (required), voice (required), bar, pos, +2 more.
add_dynamicA
An immediate dynamic (p, pp, mp, mf, f, ff, sfz, fp, ...) on the voice's instrument at a position, also where no note starts (inside a held note) or where a hairpin ends. voices: the same on several instruments. at: more dynamics in the same call, e.g. [{"value": "f", "bar": 34}, {"value": "p", "bar": 36, "beat": "2"}] (each takes bar + beat or pos). One undo step; returns only the dynamics created.
Inputs: value (required), voice (required), at, bar, +4 more.
add_flowA
Add a new flow (movement) at the end of the project, with all players.
Inputs: no named parameters.
add_grace_noteC
Add a grace note before the note at the given position (value: notated length, default quaver).
Inputs: pitch (required), voice (required), bar, pos, +3 more.
add_hairpinA
A hairpin (cresc, dim, messa_di_voce) from one position to another, e.g. bar 33 beat 0 to bar 33 beat 3/2, wherever notes start (also inside a held note). voices: put the same hairpin on several instruments (one voice each), e.g. the whole string section. A hairpin starting at a dynamic joins its group (p<), reported as merged_into. Returns the direction, positions and drawn length.
Inputs: kind (required), voice (required), bar, pos, +6 more.
add_instrumentB
Give an existing player (index in get_score_overview players) an extra instrument (doubling).
Inputs: player_id (required), instrument (required).
add_intervalB
Add a note at an interval to each given note, making a chord: "3" (third above), "-3", "maj3", "min6 below", "p5", "octave".
Inputs: interval (required), event_ids (required), flow.
add_layoutA
Add a custom score layout (optionally named). Part layouts are created automatically with players.
Inputs: name.
add_note_markingC
kind=ornament (value tr, mordent, inv, turn), hold (fermata, breath, caesura...), playing_technique (value: a name like pizz., arco, con sord., sul pont., ord., or a library id like pta.pizzText), tie, articulation (value staccato...).
Inputs: kind (required), event_ids (required), flow, value.
add_notesA
Write notes, chords and rests one after another from a position. notes: space-separated items "PITCHES:DURATION"; chords join pitches with "+"; "r" is a rest; a missing duration repeats the previous one. Durations: crotchets (1, 3/2, 1/2) or w h q e s t (+ dots, e.g. "q."). Pitches: C4 = middle C, F#5, Bb3. Example: "Eb4+G4+C5:h. G4:e Eb5:q. C5:s r:q". replace=True first clears the notes and rests of the span (slurs, text and other markings there stay); otherwise notes are added (chords merge with existing notes).
Inputs: notes (required), voice (required), bar, pos, +3 more.
add_playerB
Add a solo (or section) player holding an instrument from the library, e.g. instrument.strings.violin, instrument.wind.flute (list_library kInstrumentCollection).
Inputs: instrument (required), section.
add_rehearsal_markC
A rehearsal mark (next letter in sequence) at the start of a bar.
Inputs: bar (required), flow.
add_repeat_markerD
segno, coda, fine, "to coda", "D.C.", "D.C. al Fine", "D.C. al Coda", "D.S. al Fine", "D.S. al Coda".
Inputs: bar (required), value (required), beat, flow.
add_spanA
A line from one note to another in the same voice: slur, cresc, dim, messa_di_voce (hairpins), 8va, 8vb, 15ma, 15mb (octave lines), glissando. Only that voice gets it, even with other voices on the staff. spans: several [start_event_id, end_event_id] pairs in one call (slurs: one undo step), e.g. a slur over every pair of quavers. Hairpins end at the end of the end note; for exact positions use add_hairpin.
Inputs: kind (required), flow, spans, end_event_id, +1 more.
add_textC
Staff text (e.g. "dolce", "espress.") attached to a voice at a position.
Inputs: text (required), voice (required), bar, pos, +2 more.
add_tupletB
A tuplet typed with Dorico's note input, overwriting what is there: ratio "3:2", "5:4"; unit = the tuplet's note value (e, q, s, h); notes in add_notes syntax with notated values, e.g. "C5:e D5 E5" or "Eb4+G4:q B4 D5". Accidentals are always explicit (C#5, Ab4); plain letters mean naturals.
Inputs: unit (required), notes (required), ratio (required), voice (required), +4 more.
add_voiceB
Start a new voice on the same staff as voice (e.g. a second, stems-down voice), typing notes
(add_notes syntax, plain or single-dotted values). Returns the new voice id for later add_notes calls.
Inputs: notes (required), voice (required), bar, pos, +2 more.
check_voice_leadingA
Voice-leading check of the score: parallel and contrary fifths/octaves/unisons, hidden fifths/octaves in the outer voices, crossings, spacing over an octave between upper voices, leaps over max_leap semitones and tritone leaps. voices: from highest to lowest (default: ordered by average pitch). chords (optional harmonic plan, "bar[:beat] symbol, ...", e.g. "28 D, 28:2 A7, 29 Bm/F#") adds doubled thirds (major chords), doubled sevenths, doubled leading tone (needs key, e.g. "D" or "Bm"), missing thirds, non-chord tones and wrong bass notes. A voice holding a chord counts by its top note.
Inputs: key, flow, chords, to_bar, +3 more.
copy_rangeC
Copy (or move) notes and rests of a range to another place or voice/staff (markings are not copied).
Inputs: voice (required), dest_voice (required), flow, move, +7 more.
delete_eventsB
Delete events by id: notes, rests or markings (dynamics, hairpins, slurs, text, clefs, octave lines...). Ids come from read_music / read_markings.
Inputs: event_ids (required), flow.
delete_flowA
Delete a flow and all its music (one undo step; undo restores it). Dorico's "all music ... will also be deleted" confirmation is answered OK. The last flow cannot be deleted.
Inputs: flow_id (required).
delete_rangeB
Delete the notes, rests, grace notes and tuplets of a voice in a range (bars inclusive, or positions [from_pos, to_pos)); slurs, text and other markings in the voice stay unless include_markings=True.
Inputs: voice (required), flow, to_bar, to_pos, +3 more.
describe_commandsC
Search Dorico's 1,200 commands (regex on name/display name) with their parameters and enum values. [READ-ONLY: not yet confirmed by the live harness]
Inputs: limit, filter. Returns: result
describe_enumsB
Exact accepted values of a Dorico enum type (or regex over enum type names). [READ-ONLY: not yet confirmed by the live harness]
Inputs: name (required).
describe_propertyB
Type, display name and enum values of an event property (e.g. kNoteVelocity, kEventColour). [READ-ONLY: not yet confirmed by the live harness]
Inputs: name (required). Returns: result
dialog_clickB
Press a control in a Dorico dialog: a button ("OK", "Cancel", "Apply", "Close"), checkbox, radio button or tab, by its title, the label before it, or its path from list_dialogs. dialog: its title, if several are open.
Inputs: control (required), dialog.
dialog_setB
Set a control in a Dorico dialog: a checkbox or radio button to true/false, a text field to text, a pop-up or combo box to one of its items (by name). control: its title, the label before it, or its path.
Inputs: value (required), control (required), dialog.
dorico_statusB
Live Dorico status (mode, selection, note input, undo availability) from Remote Control. [READ-ONLY: not yet confirmed by the live harness]
Inputs: no named parameters.
edit_notesC
Apply an edit to notes: pitch_up/pitch_down (diatonic steps x count), chromatic_up/down, octave_up/down, respell_above/below, double_duration, halve_duration, tie (to the next note of the same pitch), delete; remove_rests on rest ids (Dorico's Remove Rests: the voice shows a gap there, e.g. a divisi line that pauses).
Inputs: action (required), event_ids (required), flow, count.
get_bar_mapB
Bar numbers <-> positions, time signatures (read by Dorico's own equality API, cached) and optionally key signatures (include_keys: a letter-entry probe into an empty span; it plays 7 audition notes).
Inputs: flow, include_keys.
get_optionsC
House-style options: kind kEngraving (per score), kNotation (per flow: flow_id), kLayout (per layout: layout_id). [READ-ONLY: not yet confirmed by the live harness]
Inputs: kind, filter, flow_id, layout_id. Returns: result
get_score_overviewB
Players, instruments, layouts and flows; per flow its streams and voices (voice-stream id -> instrument, staff index, voice index). Use the voice ids for read_music/add_notes.
Inputs: no named parameters.
get_selectionB
The current selection in Dorico (event type and, if available, its properties). [READ-ONLY: not yet confirmed by the live harness]
Inputs: no named parameters.
go_toC
Scroll Dorico's view to a bar.
Inputs: bar (required), flow.
layout_flowsB
Include or exclude flows in a layout (Dorico does not expose a layout's flows for read-back).
Inputs: flow_ids (required), layout_id (required), include.
list_capabilitiesB
The confirmation matrix: every capability, its mechanism and whether the live harness confirmed it. [READ-ONLY: not yet confirmed by the live harness]
Inputs: no named parameters. Returns: result
list_dialogsA
Dorico's open dialogs (every window other than a project window): title, modal, the texts shown and the controls (role, title or label, value, enabled, path). A modal dialog blocks all commands until it is answered with dialog_click / dialog_set. Needs Accessibility permission for the app running this server.
Inputs: no named parameters.
list_libraryC
Library entities (ids + names), live from Dorico: kInstrumentCollection, kClefCollection, kPlayingTechniqueAppearanceCollection, kOrnamentCollection, kTempoPresetCollection, kParagraphStyleCollection... [READ-ONLY: not yet confirmed by the live harness]
Inputs: collection (required), filter. Returns: result
playC
Start playback (from a bar, or from the playhead).
Inputs: flow, from_bar.
read_context_atC
What is in force at a point: time signature, key signature, clef, dynamic level (and a hairpin running through the point), ottava, the last tempo marking (text, bpm), and the notes sounding in the voice.
Inputs: bar, pos, beat, flow, +2 more.
read_markingsC
Dynamics (levels incl. sfz/rfz/fz, hairpins), slurs, clefs, ottavas, text, tempo (text, bpm), holds, rehearsal marks, repeats, breaks, playing techniques (name), ornaments, time/key signatures in a range. Each row says whether its content is readable. A dynamic group lists its parts in order, each with its own position (bar, beat): a level (p, f...) or a hairpin (cresc/dim, length, end); "sub" identifies a hairpin part for set_property.
Inputs: flow, to_bar, to_pos, from_bar, +1 more.
read_musicB
Notes, chords, rests (explicit and implicit), grace notes, tuplets, slurs and articulations per voice, with exact positions, durations, spelled pitches, MIDI numbers and event ids. Range: bars (inclusive) or positions [from_pos, to_pos). detail="compact": per voice and bar the notes in add_notes syntax plus their ids (about a tenth of the size; use it for long ranges or many voices). detail="grid": one row per onset of any voice (or every grid_step crotchets, e.g. "1/2") with what each voice sounds, for checking verticals.
Inputs: flow, detail, to_bar, to_pos, +4 more.
redoA
Redo count steps. Only possible right after undo: every MCP read runs a Dorico script, and any
script clears Dorico's redo stack (verified).
Inputs: count.
refreshA
Forget cached reads (time signatures, dynamics, keys, structure); use after editing in Dorico by hand. [READ-ONLY: not yet confirmed by the live harness]
Inputs: no named parameters.
remove_instrumentA
Remove an instrument and all its music (one undo step; undo restores it). Instrument ids are in get_score_overview players. Dorico's "will also delete all its music" confirmation is answered OK.
Inputs: instrument_id (required).
rename_flowB
Rename a flow (ids from get_score_overview flows).
Inputs: name (required), flow_id (required).
rename_layoutB
Rename a layout (ids from get_score_overview layouts).
Inputs: name (required), layout_id (required).
rename_playerC
Rename a player (index in get_score_overview players).
Inputs: name (required), player_id (required), short_name.
run_commandA
Escape hatch: run any catalogued Dorico command ("Namespace.Command?Param=value&..."), validated against the catalogue. With select_event_id the event is selected first in the same undo step.
Inputs: command (required), flow, select_event_id.
score_changesA
What changed in a flow: without since, take a snapshot and return its token; with since=, list the events added, removed and changed since then, each marked by "server" (written through these tools) or "Dorico" (edited in Dorico by hand), and a new token. Changes inside dynamic groups (levels) are not seen.
Inputs: flow, since.
screenshotB
A picture of Dorico's score window, to check engraving by eye. bar: scroll there first; zoom: view zoom in percent for the picture (e.g. 200 to read dynamics and small markings), restored afterwards.
Inputs: bar, flow, zoom.
select_eventsB
Select an event in Dorico (e.g. to show the user). Note: selection changes are undo steps in Dorico.
Inputs: event_ids (required), flow.
set_durationC
Change a note's or rest's duration (crotchets or w h q e s t with dots).
Inputs: duration (required), event_id (required), flow.
set_key_signatureC
Key signature from a bar on: "2#", "3b", "0", or names like "Eb", "F#m", "c minor".
Inputs: bar (required), value (required), beat, flow.
set_optionA
Set a house-style option (paths and values from get_options). kind: kEngraving, kNotation (flow_ids), kLayout (layout_ids). Written via Dorico's own commands (the setoptions message ignores layout ids).
Inputs: kind (required), path (required), value (required), flow_ids, +1 more.
set_pitchA
Change one note's pitch and spelling (e.g. "F#4", "Ebb5") in place: it keeps its id, rhythm, slurs and articulations.
Inputs: pitch (required), event_id (required), flow.
set_propertyB
Set any event property (all layouts), e.g. kNoteVelocity=100, kEventColour=#ffff0000, kEventScale=kCue, kNoteForcedVoiceDirection... Omit value to reset to default. See describe_property. kDynamicGradualChangeDuration (hairpin length in crotchets) also works on a hairpin joined to a dynamic (p<); part: the hairpin's "sub" from read_markings when its group holds several hairpins (> <).
Inputs: name (required), event_ids (required), flow, part, +1 more.
set_score_orderC
Instrument order template, e.g. instrumentscoreorder.orchestral, instrumentscoreorder.windband, instrumentscoreorder.choral (list_library kInstrumentScoreOrderCollection).
Inputs: order (required).
set_tempoD
A tempo marking: "q=120", "Allegro q=132", "h.=60", "rit.", "a tempo".
Inputs: value (required), bar, pos, beat, +1 more.
set_time_signatureC
Time signature from a bar on: 3/4, 6/8, 2+3/8, c, cut. Single n/d values are read back to confirm.
Inputs: bar (required), value (required), flow.
stopA
Stop playback.
Inputs: no named parameters.
swap_voicesB
Exchange the notes and rests of two voices in a range (e.g. divisi lines trading places), one undo step. Notes are re-created with their pitch and rhythm (new ids); slurs, text and markings stay in their voice.
Inputs: voice (required), other_voice (required), flow, to_bar, +3 more.
undoA
Undo the last count edits in Dorico (every tool write is one step). Selection steps left by this server's
tempo reads are skipped; other selection changes (by hand, select_events) count as steps.
Inputs: count.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 66 tools
Most tools have a clear verb+object purpose (add_notes, read_markings, set_tempo), but several overlap: add_span vs add_hairpin both create hairpins, add_articulation vs add_note_marking (kind=articulation) both add articulations, and delete_range vs delete_events both remove content. set_property and run_command are generic catch-alls that could do almost anything, though the descriptions do explicitly point to the specialised tool ('for exact positions use add_hairpin'), which keeps misselection recoverable rather than fatal.
The dominant pattern is verb_noun (add_player, get_score_overview, read_music, delete_flow, set_pitch), applied consistently across the large write surface. Deviations are limited to a few noun_verb tools (dialog_click, dialog_set, layout_flows, score_changes) and bare-verb transport tools (play, stop, undo, redo, refresh, screenshot), which are conventional enough not to break predictability.
66 tools is far beyond what an agent can comfortably scan and choose from in one surface, even for a rich domain like score engraving. The set is really several servers in one (transport/undo, accessors, music reading, note writing, markings, dialogs, house style), and should have been grouped or narrowed.
Coverage is unusually thorough: status/diagnostics, structure (players, flows, layouts), reads (music, markings, context, bar map, changes), note and marking writes, options, dialogs and an escape hatch, plus undo/redo. Minor gaps remain — no remove_player or delete_layout (removal exists for instruments and flows only), no transpose/bulk pitch-shift beyond edit_notes, and no way to read back a layout's flows (layout_flows is write-only).
Maintenance
Related MCP Connectors
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
Let Claude read and edit your KudoWrite novels: chapters, beats, story bible and book summary.
Give Claude a whiteboard: notes, links, images and diagrams on a board you both see and edit.
Work with your DealSharp negotiation projects, documents and tools from Claude.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables Claude AI to convert, edit, and analyze MuseScore files (.mscz, .musicxml, MIDI) through natural language commands, supporting format conversion, transposition, harmony analysis, and more.201-
- AlicenseBqualityDmaintenanceEnables Claude to observe and compose in Ableton Live 12 via AbletonOSC, allowing pair-programming-style collaboration for musicians.13MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables natural language control of Steinberg Dorico music notation software through Claude Desktop or ChatGPT, offering tools for score creation, note input, notation, harmony analysis, and orchestration.5415MIT
- FlicenseNot gradedqualityCmaintenanceEnables Claude AI to control Ableton Live and Max for Live, allowing music production tasks like track management, MIDI editing, and pattern generation directly from conversation.-