edit_notes
Edit chosen MIDI notes in a clip without rewriting: delete, transpose, shift, quantize, set velocity, length, mute, or probability by beat range and pitch.
Instructions
Change some notes of a MIDI clip without rewriting it: delete, transpose, shift in time, quantize starts to a grid, set velocity or length, mute or unmute, set probability, velocity deviation or release velocity.
Choose notes by start time (from_beats/to_beats) and pitches; with neither, all notes. Notes that would leave the MIDI range or the clip start are skipped and listed. One undo step. To replace all notes use write_clip.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "edit_notes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip | No | A clip by address instead of track and slot: t0/s2 (Session slot 2 of t0) or t0/a1 (the second timeline clip of t0, see arrangement list). | |
| slot | No | Clip slot: the scene row, from 0. Example: 0 for the first scene. | |
| beats | No | For shift: move by this many beats, e.g. 0.5 or -1. | |
| track | No | Track address of a Session clip, e.g. t0 (with slot). | |
| value | No | For probability (0-1), velocity_deviation (-127 to 127) and release_velocity (0-127). | |
| action | Yes | What to do with the chosen notes. | |
| pitches | No | Only these pitches, e.g. ["C3", "E3"] or ["60"]. Empty: all pitches. | |
| to_beats | No | Only notes starting before this beat. | |
| velocity | No | For velocity: new velocity 1-127. | |
| semitones | No | For transpose: e.g. 12 or -5. | |
| from_beats | No | Only notes starting at or after this beat. | |
| grid_beats | No | For quantize: grid in beats, e.g. 0.25 for 1/16 notes. | |
| length_beats | No | For length: new note length in beats. |