remove_from_timeline
Remove clips from your Premiere Pro timeline with options to ripple delete (close gaps) or lift (leave gaps). This tool helps streamline video editing workflows by eliminating unwanted footage directly from the timeline.
Instructions
Removes a clip from the timeline.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clipId | Yes | The ID of the clip on the timeline to remove | |
| deleteMode | No | Whether to ripple delete (close gap) or lift (leave gap) |
Implementation Reference
- src/tools/index.ts:1026-1063 (handler)The core handler function for the 'remove_from_timeline' tool. It constructs and executes an ExtendScript via the PremiereProBridge to locate the clip by ID on the active sequence timeline and remove it using either 'ripple' (closes gap) or 'lift' (leaves gap) mode.
private async removeFromTimeline(clipId: string, deleteMode = 'ripple'): Promise<any> { const script = ` try { var clip = app.project.getClipByID("${clipId}"); if (!clip) { JSON.stringify({ success: false, error: "Clip not found" }); return; } var clipName = clip.name; var track = clip.getTrack(); if ("${deleteMode}" === "ripple") { track.removeClip(clip, true); // ripple delete } else { track.removeClip(clip, false); // lift delete } JSON.stringify({ success: true, message: "Clip removed from timeline", clipId: "${clipId}", clipName: clipName, deleteMode: "${deleteMode}" }); } catch (e) { JSON.stringify({ success: false, error: e.toString() }); } `; return await this.bridge.executeScript(script); } - src/tools/index.ts:157-160 (schema)Zod input schema defining parameters for the tool: clipId (required string) and optional deleteMode (enum: 'ripple' or 'lift'). Used for validation in executeTool.
inputSchema: z.object({ clipId: z.string().describe('The ID of the clip on the timeline to remove'), deleteMode: z.enum(['ripple', 'lift']).optional().describe('Whether to ripple delete (close gap) or lift (leave gap)') }) - src/tools/index.ts:464-465 (registration)Dispatch in executeTool switch statement that routes calls to the removeFromTimeline handler after schema validation.
case 'remove_from_timeline': return await this.removeFromTimeline(args.clipId, args.deleteMode); - src/tools/index.ts:154-161 (registration)Tool registration in getAvailableTools() array, providing name, description, and schema for MCP tool discovery.
{ name: 'remove_from_timeline', description: 'Removes a clip from the timeline.', inputSchema: z.object({ clipId: z.string().describe('The ID of the clip on the timeline to remove'), deleteMode: z.enum(['ripple', 'lift']).optional().describe('Whether to ripple delete (close gap) or lift (leave gap)') }) },