AbletonMCP

Implementation Reference

• MCP_Server/server.py:307-324 (handler)

  MCP tool handler for 'add_notes_to_clip'. Proxies parameters to the Ableton remote script via socket command.

  @mcp.tool()
  def add_notes_to_clip(
      ctx: Context,
      track_index: int,
      clip_index: int,
      notes: List[Dict[str, Union[int, float, bool]]]
  ) -> str:
      try:
          ableton = get_ableton_connection()
          result = ableton.send_command("add_notes_to_clip", {
              "track_index": track_index,
              "clip_index": clip_index,
              "notes": notes
          })
          return f"Added {len(notes)} notes to clip at track {track_index}, slot {clip_index}"
      except Exception as e:
          logger.error(f"Error adding notes to clip: {str(e)}")
          return f"Error adding notes to clip: {str(e)}"

• MCP_Server/server.py:308-313 (schema)

  Input schema defined by function parameters: track_index (int), clip_index (int), notes (List[Dict[str, Union[int, float, bool]]]) expecting note dicts with keys like pitch, start_time, duration, velocity, mute.

  def add_notes_to_clip(
      ctx: Context,
      track_index: int,
      clip_index: int,
      notes: List[Dict[str, Union[int, float, bool]]]
  ) -> str:

• AbletonMCP_Remote_Script/__init__.py:573-611 (handler)

  Core Ableton Live API implementation of add_notes_to_clip. Converts note dicts to tuple format and calls clip.set_notes() to add MIDI notes.

  def _add_notes_to_clip(self, track_index, clip_index, notes):
      """Add MIDI notes to a clip"""
      try:
          if track_index < 0 or track_index >= len(self._song.tracks):
              raise IndexError("Track index out of range")
          
          track = self._song.tracks[track_index]
          
          if clip_index < 0 or clip_index >= len(track.clip_slots):
              raise IndexError("Clip index out of range")
          
          clip_slot = track.clip_slots[clip_index]
          
          if not clip_slot.has_clip:
              raise Exception("No clip in slot")
          
          clip = clip_slot.clip
          
          # Convert note data to Live's format
          live_notes = []
          for note in notes:
              pitch = note.get("pitch", 60)
              start_time = note.get("start_time", 0.0)
              duration = note.get("duration", 0.25)
              velocity = note.get("velocity", 100)
              mute = note.get("mute", False)
              
              live_notes.append((pitch, start_time, duration, velocity, mute))
          
          # Add the notes
          clip.set_notes(tuple(live_notes))
          
          result = {
              "note_count": len(notes)
          }
          return result
      except Exception as e:
          self.log_message("Error adding notes to clip: " + str(e))
          raise

• AbletonMCP_Remote_Script/__init__.py:256-260 (registration)

  Command dispatching/registration in remote script's _process_command method that routes 'add_notes_to_clip' to the handler function.

  elif command_type == "add_notes_to_clip":
      track_index = params.get("track_index", 0)
      clip_index = params.get("clip_index", 0)
      notes = params.get("notes", [])
      result = self._add_notes_to_clip(track_index, clip_index, notes)