get_timeline_clips
Retrieve all video and audio clips from the active Premiere Pro timeline with detailed metadata for editing, analysis, or automation workflows.
Instructions
Get all clips in the active sequence with detailed information
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- mcp-server.js:526-567 (handler)The main handler function for the 'get_timeline_clips' tool. It fetches clip data from a local HTTP server (port 3001), processes it, limits to first 20 clips, formats a detailed list with track info, timings, source paths, speed, and effects, and returns it as a formatted text response. Handles errors appropriately.
async getTimelineClips() { try { const response = await fetch('http://localhost:3001/api/timeline-clips'); if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`); const data = await response.json(); if (data.error) { return { content: [ { type: 'text', text: `⚠️ ${data.error}`, }, ], }; } const clipsList = data.clips.slice(0, 20).map(clip => `• **${clip.clip_name}** (${clip.track_type}${clip.track_number})\n 📍 ${clip.timeline_in} → ${clip.timeline_out} (${clip.duration})\n 📁 ${clip.source_file_path.split('\\').pop()}\n ⚡ ${clip.speed}% ${clip.effects.length > 0 ? `| Effects: ${clip.effects.join(', ')}` : ''}` ).join('\n\n'); return { content: [ { type: 'text', text: `🎬 **Timeline Clips (${data.total_clips} total${data.total_clips > 20 ? ', showing first 20' : ''})**\n\n${clipsList}`, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `❌ **Failed to get timeline clips**\n\nError: ${error.message}`, }, ], isError: true, }; } } - mcp-server.js:237-238 (registration)Registration in the tool dispatcher switch statement within the CallToolRequestSchema handler, which routes calls to the getTimelineClips method.
case 'get_timeline_clips': return await this.getTimelineClips(); - mcp-server.js:83-91 (schema)Tool registration entry in the ListToolsRequestSchema handler, including the tool name, description, and input schema (empty object, no parameters required).
{ name: "get_timeline_clips", description: "Get all clips in the active sequence with detailed information", inputSchema: { type: "object", properties: {}, required: [] } }, - mcp-server.js:83-91 (registration)The tool is registered here in the list of available tools returned by listTools.
{ name: "get_timeline_clips", description: "Get all clips in the active sequence with detailed information", inputSchema: { type: "object", properties: {}, required: [] } },