clear_envelope_points
Remove automation envelope points within a specified time range or across the entire timeline in REAPER projects. Identify envelopes by name or index to delete points and clean up automation data.
Instructions
Delete all automation envelope points in the given time range (default: entire timeline). Identify the envelope by name (e.g. 'Volume', 'Pan') or by 0-based envelope_index.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| track_index | Yes | ||
| envelope_index | No | ||
| envelope_name | No | ||
| t1 | No | ||
| t2 | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/reaper_mcp/reaper_adapter.py:565-580 (handler)The adapter method that calls the Lua bridge to clear envelope points.
def clear_envelope_points( self, track_index: int, envelope_index: int | None = None, envelope_name: str | None = None, t1: float = 0.0, t2: float = 1e12, ) -> dict[str, Any]: return self._client.call( "clear_envelope_points", track_index=track_index, envelope_index=envelope_index, envelope_name=envelope_name, t1=t1, t2=t2, ) - src/reaper_mcp/server.py:1086-1108 (registration)The MCP tool definition and registration for clear_envelope_points.
def clear_envelope_points( track_index: int, envelope_index: int | None = None, envelope_name: str | None = None, t1: float = 0.0, t2: float = 1e12, ) -> dict[str, Any]: """ Delete all automation envelope points in the given time range (default: entire timeline). Identify the envelope by name (e.g. 'Volume', 'Pan') or by 0-based envelope_index. """ try: return _wrap( adapter.clear_envelope_points( track_index=track_index, envelope_index=envelope_index, envelope_name=envelope_name, t1=t1, t2=t2, ) ) except Exception as exc: return _err(exc)