mcp_opendaw_merge_note_tracks
Merge notes from a source track into a destination track, resolving overlaps by velocity or priority rules. Optionally delete the source track after merging.
Instructions
Merge notes from a source track into a destination track.
Combines notes from two tracks into one, optionally deleting the source. Overlapping notes are resolved by the chosen strategy. Unlike copy_notes_to_track (which just copies), merge consolidates two note streams into a single coherent track — the source notes are integrated into the destination region and optionally removed from origin.
Typical use cases:
Merge a doubled melody into the main melody track
Consolidate counterpoint into the harmony track
Combine left-hand and right-hand piano into one track
Flatten multi-track MIDI into a single instrument
Args: source_unit: AU index of source track source_track: Note track index within source AU dest_unit: AU index of destination track dest_track: Note track index within destination AU source_region: Source region index (-1 = first region) dest_region: Destination region index (-1 = first region, or auto-create if none exists) delete_source: If True, delete source notes after merge. If False, notes remain in both tracks (copy mode). resolve_overlaps: Strategy for overlapping notes — "keep_higher_velocity" = keep louder note at conflict point, "keep_lower_velocity" = keep quieter note, "keep_source" = prefer source notes, "keep_dest" = prefer destination notes, "keep_both" = keep all overlapping notes (no resolution), "shorten_earlier" = truncate the earlier-starting note to end where the later one begins. transpose: Semitones to transpose source notes (-24 to 24).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dest_unit | Yes | ||
| transpose | No | ||
| dest_track | Yes | ||
| dest_region | No | ||
| source_unit | Yes | ||
| source_track | Yes | ||
| delete_source | No | ||
| source_region | No | ||
| resolve_overlaps | No | keep_higher_velocity |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |