Skip to main content
Glama
doricomcp

doricomcp

by kulbiq

doricomcp

PyPI Release MCP Registry CI License: MIT

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:

      {
        "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).

  3. 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.

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

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_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).

  • 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/244 is A4 a quarter-tone sharp, C-1/245 is C5 a quarter-tone flat, D1/85 is 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

dorico_status

Live Dorico status (mode, selection, note input, undo availability) from Remote Control.

read-only

list_capabilities

The confirmation matrix: every capability, its mechanism and whether the live harness confirmed it.

read-only

describe_commands

Search Dorico's 1,200 commands (regex on name/display name) with their parameters and enum values.

read-only

describe_enums

Exact accepted values of a Dorico enum type (or regex over enum type names).

read-only

describe_property

Type, display name and enum values of an event property (e.g. kNoteVelocity, kEventColour).

read-only

list_library

Library entities (ids + names), live from Dorico: kInstrumentCollection, kClefCollection, kPlayingTechniqueAppearanceCollection ...

read-only

run_command

Escape hatch: run any catalogued Dorico command ("Namespace.Command?Param=value&..."), validated against the catalogue.

confirmed live

screenshot

A picture of Dorico's score window, to check engraving by eye.

confirmed live

list_dialogs

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

dialog_click

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

dialog_set

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

refresh

Forget cached reads (time signatures, dynamics, keys, structure); use after editing in Dorico by hand.

read-only

Read

Tool

What it does

Status

get_score_overview

Players, instruments, layouts and flows; per flow its streams and voices (voice-stream id -> instrument, staff index, voice index).

confirmed live

get_bar_map

Bar numbers <-> positions, time signatures (read by Dorico's own equality API, cached) and optionally key signatures (include_keys: a ...

confirmed live

read_music

Notes, chords, rests (explicit and implicit), grace notes, tuplets, slurs and articulations per voice, with exact positions, durations ...

confirmed live

read_markings

Dynamics (levels incl. sfz/rfz/fz, hairpins), slurs, clefs, ottavas, text, tempo (text, bpm), holds, rehearsal marks, repeats, breaks ...

confirmed live

read_context_at

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

check_voice_leading

Voice-leading check of the score: parallel and contrary fifths/octaves/unisons, hidden fifths/octaves in the outer voices, crossings ...

confirmed live

score_changes

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

get_selection

The current selection in Dorico (event type and, if available, its properties).

read-only

get_options

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

add_notes

Write notes, chords and rests one after another from a position.

confirmed live

delete_range

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

Delete events by id: notes, rests or markings (dynamics, hairpins, slurs, text, clefs, octave lines...).

confirmed live

set_pitch

Change one note's pitch and spelling (e.g. "F#4", "Ebb5") in place: it keeps its id, rhythm, slurs and articulations.

confirmed live

set_duration

Change a note's or rest's duration (crotchets or w h q e s t with dots).

confirmed live

edit_notes

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_interval

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_grace_note

Add a grace note before the note at the given position (value: notated length, default quaver).

confirmed live

copy_range

Copy (or move) notes and rests of a range to another place or voice/staff (markings are not copied).

confirmed live

add_tuplet

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

swap_voices

Exchange the notes and rests of two voices in a range (e.g. divisi lines trading places), one undo step.

confirmed live

add_voice

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 ...

confirmed live

Write: markings

Tool

What it does

Status

add_articulation

staccato, staccatissimo, tenuto, accent, marcato, stress, unstress, staccato_tenuto on notes.

confirmed live

add_span

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

add_hairpin

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

add_dynamic

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

add_note_marking

kind=ornament (value tr, mordent, inv, turn), hold (fermata, breath, caesura...), playing_technique (value: a name like pizz., arco, con ...

confirmed live

add_text

Staff text (e.g. "dolce", "espress.") attached to a voice at a position.

confirmed live

add_clef

A clef change on the voice's staff: clef.treble, clef.bass, clef.alto, clef.tenor, clef.treble8ba .

confirmed live

set_tempo

A tempo marking: "q=120", "Allegro q=132", "h.=60", "rit.", "a tempo".

confirmed live

set_time_signature

Time signature from a bar on: 3/4, 6/8, 2+3/8, c, cut.

confirmed live

set_key_signature

Key signature from a bar on: "2#", "3b", "0", or names like "Eb", "F#m", "c minor".

confirmed live

add_barline

Barline at the start of a bar: "||" double, "|:" start repeat, ":|" end repeat, ":|:", "|||" final, ":" dashed.

confirmed live

add_repeat_marker

segno, coda, fine, "to coda", "D.C.", "D.C.

confirmed live

add_rehearsal_mark

A rehearsal mark (next letter in sequence) at the start of a bar.

confirmed live

add_break

Force a system or frame (page) break before a bar.

confirmed live

set_property

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_option

Set a house-style option (paths and values from get_options).

confirmed live

add_player

Add a solo (or section) player holding an instrument from the library, e.g. instrument.strings.violin, instrument.wind.flute (list_library ...

confirmed live

add_instrument

Give an existing player (index in get_score_overview players) an extra instrument (doubling).

confirmed live

rename_player

Rename a player (index in get_score_overview players).

confirmed live

add_flow

Add a new flow (movement) at the end of the project, with all players.

confirmed live

rename_flow

Rename a flow (ids from get_score_overview flows).

confirmed live

delete_flow

Delete a flow and all its music (one undo step; undo restores it).

confirmed live

remove_instrument

Remove an instrument and all its music (one undo step; undo restores it).

confirmed live

add_layout

Add a custom score layout (optionally named).

confirmed live

rename_layout

Rename a layout (ids from get_score_overview layouts).

confirmed live

layout_flows

Include or exclude flows in a layout (Dorico does not expose a layout's flows for read-back).

confirmed live

set_score_order

Instrument order template, e.g. instrumentscoreorder.orchestral, instrumentscoreorder.windband, instrumentscoreorder.choral (list_library ...

confirmed live

Navigation, playback, history

Tool

What it does

Status

go_to

Scroll Dorico's view to a bar.

confirmed live

select_events

Select an event in Dorico (e.g. to show the user).

confirmed live

play

Start playback (from a bar, or from the playhead).

confirmed live

stop

Stop playback.

confirmed live

undo

Undo the last count edits in Dorico (every tool write is one step).

confirmed live

redo

Redo count steps.

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 and NoteInput.StartLyricInput plus AcceptCurrentLyricInput?LyricText= from a script created no lyric. Next: send the same two commands from Remote Control (not Lua) with the note selected, and try the EventCreationLocation parameter; 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, so h.=60 and q=60 both read 60. Next: record the definition when set_tempo writes it (as add_voice records 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's status message carries the selected note's articulation flags (articulationStaccato, ...).

  • div. and unis. (add_text). They are written as staff text; Dorico's real divisi is Edit.AddDivisi / Edit.RestoreUnison, which open the Change Divisi dialog. Next: drive that dialog with the existing dialog tools, as delete_flow does 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 CreateKeySignature ignores a tonalitySystemID parameter. Next: look for the panel's command in Remote Control's command list after choosing a system there by hand.

  • Deleting players (remove_instrument removes instruments). Project.Players.Delete needs a player selected in Setup mode, and Project.Players.DeleteEmpty opens a dialog listing every player without music, not just one. Next: select the one player in that dialog with dialog_set before pressing Delete Selected Players.

  • Copy and move with markings (copy_range). Lua's copyRange is 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, as add_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 with check_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 undo skips 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 tools
add_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

    C2.7/5.0

    Scored across 66 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers