capcut-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@capcut-mcp-server Add a subtitle track and background music to my current draft"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
CapCut Desktop MCP Server & Agent Skills π¬
Enterprise-grade Model Context Protocol (MCP) server & Agent Skills for CapCut Desktop & JianYing Pro (εͺζ ).
Programmatic video editing, multi-track timeline construction, Quad Ease keyframing, and viral typography for Claude Desktop, Cursor AI, Google Antigravity, Cline, and Windsurf.
π Table of Contents
Related MCP server: capcut-mcp
π‘ Why CapCut MCP?
Traditional AI video editing attempts rely on brittle GUI automation: simulating mouse clicks, keystrokes, and window focusing that fail when UI elements shift or screen resolutions vary.
CapCut MCP takes an entirely different approach:
Direct AST Manipulation: It reads and writes directly to CapCut's native
draft_content.jsonAbstract Syntax Tree (AST).Instant & Deterministic: Timelines, multi-track sequences, cuts, speed ramps, and keyframes apply in milliseconds without opening the GUI.
Cross-Platform: Works natively with both CapCut Global and JianYing Pro (εͺζ ) on Windows and macOS.
Zero Window Focus: Edits run cleanly in the background while you continue working.
π Architecture & Direct AST Engine
User Prompt (e.g. "Cut dead air, add viral captions, punch zoom on keywords")
β
βΌ
AI Agent (Claude Desktop / Cursor / Antigravity)
β
βΌ (Model Context Protocol JSON-RPC)
capcut-mcp-server
β
βββββββββββββββββββββββββΌββββββββββββββββββββββββ
βΌ βΌ βΌ
CapCut Path Resolver Media Probe (FFprobe) Draft Manager
(CapCut Global / JianYing) β
βΌ
Draft Builder
(Native AST Generator)
β
βΌ
CapCut Project Directory
(%LOCALAPPDATA%/CapCut/...)
β
βΌ
Native CapCut Project Readypaths.ts: Dynamically detects CapCut Global or JianYing Pro directories without hardcoded user paths.draft-builder.ts: Pure deterministic constructor for clips, keyframes, transitions, text materials, and multi-track audio.draft-manager.ts: High-level timeline orchestrator providing safe atomic file writes and project registration.preview-renderer.ts: Generates headless proxy MP4 previews via FFmpeg without launching the CapCut application.
β¨ Key Features
π¬ 24 Atomic Video Editing Tools: Complete programmatic control over projects, multi-track timelines, transformations, speed scaling, audio fades, subtitles, and keyframes.
β‘ Multi-Track Orchestration: Base A-roll, overlay B-roll layers, background music with audio ducking (-12dB), sound effects, and text caption tracks.
π₯ Viral Typography Engine: Built-in support for high-retention short-form styles (Style 6 Glow Pop, Style 7 Hero Typography, -1.0 metric tracking, ambient drop shadows, and scale pop animations).
π Mathematical Keyframing & Easing: Quad Ease Out curves, kinetic punch-in zooms, smooth opacity transitions, and position pans.
π― Synchronized Subtitles: Parse and import standard SRT files directly into formatted native CapCut text layers.
πΌοΈ Fast Headless Previews: Render fast proxy preview MP4s using FFmpeg without opening the CapCut GUI.
π€ Production Agent Skills Included: Battle-tested prompt playbooks and references in
skills/capcut/covering Walter Murch's Rule of Six, B-roll sourcing, and Quad Easing.
π Quick Start
1. Global Installation (Recommended)
# Run directly via npx
npx capcut-mcp-server
# Or install globally via npm
npm install -g capcut-mcp-server2. Run from Source
git clone https://github.com/AiPersonacademy/capcut-mcp.git
cd capcut-mcp
npm install
npm run build
npm test
npm startπ Client Configuration
Claude Desktop
Add this configuration to your claude_desktop_config.json:
{
"mcpServers": {
"capcut": {
"command": "npx",
"args": ["-y", "capcut-mcp-server"]
}
}
}Config file locations:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Cursor AI
Add to your .cursor/mcp.json or global MCP settings:
{
"mcpServers": {
"capcut": {
"command": "npx",
"args": ["-y", "capcut-mcp-server"]
}
}
}Google Antigravity
Add to your mcp_config.json:
{
"mcpServers": {
"capcut": {
"command": "node",
"args": ["<ABSOLUTE_PATH_TO_CAPCUT_MCP>/dist/src/index.js"]
}
}
}Windsurf & Cline
Configure the stdio command:
{
"mcpServers": {
"capcut": {
"command": "npx",
"args": ["-y", "capcut-mcp-server"]
}
}
}π οΈ MCP Tools Reference (24 Atomic Tools)
Tool Name | Category | Description | Key Parameters |
| Projects | Lists all local CapCut projects with duration, resolution, and track counts | None |
| Projects | Fetches the full timeline structure, tracks, media materials, and duration |
|
| Projects | Creates a new project draft with custom canvas dimensions (e.g. 1080x1920) |
|
| Projects | Duplicates an existing project draft under a new name |
|
| Projects | Safely deletes a project folder from CapCut storage |
|
| Projects | Launches CapCut Desktop or opens project directory in Explorer |
|
| Timeline | Inserts or appends a video clip onto any track index |
|
| Audio | Adds background music or voiceover with volume control |
|
| Audio | Inserts SFX (whooshes, pops, risers, impacts) at exact timestamps |
|
| Audio | Applies smooth fade-in and fade-out volume curves |
|
| Editing | Trims in/out source points and target duration of an existing clip |
|
| Editing | Splits a clip at an exact timeline timestamp |
|
| Editing | Removes a specific clip from a timeline track |
|
| Transform | Adjusts 2D position |
|
| Transform | Modifies speed multiplier (0.1x to 100.0x) with pitch preservation |
|
| Animation | Adds keyframe animation for scale, position, or opacity |
|
| Transitions | Adds native video transitions (dissolve, push, zoom, wipe) |
|
| Text | Injects static text, titles, or lower thirds |
|
| Text | Parses and imports complete SRT subtitle files into text tracks |
|
| Text | Adds viral dynamic caption with accent words and hover-pop animations |
|
| Graphics | Places graphic stickers or overlays on the timeline |
|
| Sequencing | Creates a multi-track sequenced project with video plates & audio ducking |
|
| Utilities | Probes video/audio resolution, duration, codecs, and framerate |
|
| Utilities | Generates a fast proxy preview MP4 via headless FFmpeg |
|
π¨ Viral Typography Engine
Short-form retention depends on visual stimulation and dynamic typography. CapCut MCP comes with pre-calibrated viral styles accessible via capcut_add_viral_caption:
Style 6: Glow Pop
Font: Montserrat ExtraBold / Impact
Primary Color: High-saturation electric yellow (
#FFE600) or lime (#00FF66)Stroke: Heavy black outline (
#000000, width12-16)Drop Shadow: Ambient soft blur
Pop Motion: Scale burst (1.15x -> 1.0x) over 120ms at word boundary
Style 7: Hero Typography
Character Spacing:
-1.0metric tracking (tight, cinematic feel)Casing: Uppercase
Shadow Offset:
(26, 26)with 85% opacityColor Accent: Single focal word highlighted in cyan (
#00E5FF) or electric magenta (#FF0055)
π€ AI Agent Skills & Editorial Playbooks
This repository includes a dedicated Agent Skill located at skills/capcut/SKILL.md.
When connected to an AI agent, the agent can autonomously follow the Autonomous Editing Playbook:
Probe: Inspect raw files with
capcut_get_media_info.Scaffold: Create the project canvas with
capcut_create_project.Assemble A-Roll: Place primary speech clips on Track 0 with
capcut_add_video_clip.Synchronize Subtitles: Inject timed captions with
capcut_add_subtitlesor kinetic titles withcapcut_add_viral_caption.Overlay B-Roll: Insert relevant visual cutaways on Track 1 with punch-in zoom keyframes.
Sound Design: Add background music (ducked to -12dB) with
capcut_add_audio_clipand impact transients withcapcut_add_sound_effect.Review: Generate an instant proxy preview with
capcut_generate_previewor open CapCut Desktop withcapcut_open_app.
For comprehensive editorial reference manuals, see:
π§ͺ Testing & Quality Assurance
The test suite validates timeline calculations, AST segment generation, track collisions, speed scaling, and SRT subtitle ingestion:
npm testβΆ CapCut MCP Server - Comprehensive Suite
β SrtParser parses standard SRT format accurately (3.0ms)
β DraftManager creates a 9:16 project and registers in root meta (46.1ms)
β MediaProbe and addVideoClip with synthetic video (219.5ms)
β DraftManager adds audio clip (133.6ms)
β DraftManager sets clip transform (24.3ms)
β DraftManager trims existing clip (16.4ms)
β DraftManager adds transition to clip (27.2ms)
β DraftManager adds keyframe to clip (16.5ms)
β DraftManager adds sticker to project (25.0ms)
β DraftManager renders fast proxy preview via ffmpeg (409.5ms)
β DraftManager adds text overlays to a project (19.8ms)
β DraftManager adds synchronized subtitles from SRT (22.8ms)
β DraftManager splits an existing clip accurately (25.2ms)
β DraftManager sets clip speed and preserves pitch (26.8ms)
β DraftManager adds audio fade-in and fade-out (25.1ms)
β DraftManager adds viral caption with Aeovisuals styling (23.4ms)
β DraftManager creates video bridge draft (203.1ms)
β DraftManager adds transient sound effect (96.8ms)
β DraftManager duplicates a project (22.3ms)
β DraftManager deletes a project safely (13.1ms)
β CapCut MCP Server - Comprehensive Suite (2805ms)
βΉ tests 21 | pass 21 | fail 0π€ Contributing
Contributions are warmly welcomed! Please see CONTRIBUTING.md for details on development workflow, code style, and PR submissions.
π License
Distributed under the MIT License. See LICENSE for details.
Available Tools
24 toolscapcut_add_audio_clipC
Adds background music, sound effects, or voiceover audio to an audio track.
Inputs: file_path (required), project_name_or_id (required), volume, track_index, +3 more.
capcut_add_audio_fadeA
Adds smooth volume fade-in and/or fade-out envelopes to an audio track segment, eliminating abrupt audio cutoffs in background music or dialogue.
Inputs: segment_id (required), project_name_or_id (required), fade_in_seconds, fade_out_seconds.
capcut_add_keyframeC
Adds an animation keyframe for scale, rotation, translation (x, y), or opacity to a video segment.
Inputs: value (required), property (required), segment_id (required), project_name_or_id (required), +1 more.
capcut_add_sound_effectA
Drops a transient sound effect (whoosh, pop, click, riser impact) at an exact timeline timestamp, aligned with visual keyframes or text pops.
Inputs: sfx_file_path (required), timestamp_seconds (required), project_name_or_id (required), volume, +1 more.
capcut_add_stickerB
Adds an animated sticker or graphic element to the project timeline.
Inputs: sticker_name (required), project_name_or_id (required), x, y, +4 more.
capcut_add_subtitlesA
Batch adds synchronized subtitles / captions from an array of items, an SRT file path, or raw SRT string.
Inputs: project_name_or_id (required), y, font_size, subtitles, +5 more.
capcut_add_textC
Adds a customizable title, lower-third, or text overlay to a text track.
Inputs: text (required), project_name_or_id (required), x, y, +8 more.
capcut_add_transitionA
Adds a transition effect (e.g. Dissolve, Fade to Black, Fade to White, Zoom In) between clips on a video track.
Inputs: segment_id (required), project_name_or_id (required), transition_name, duration_seconds.
capcut_add_video_clipB
Adds a video or image file to a CapCut video track. Media metadata (duration, resolution) is automatically probed.
Inputs: file_path (required), project_name_or_id (required), x, y, +7 more.
capcut_add_viral_captionB
Injects Aeovisuals-calibrated viral typography with -1.0 metric kerning, 26/26 diffuse ambient shadow, custom font, power word scaling/color contrast, and optional Quad Ease hover-up pop keyframes.
Inputs: text (required), project_name_or_id (required), x, y, +8 more.
capcut_create_projectA
Creates a brand new CapCut project draft with canvas resolution and frame rate, registered directly into CapCut Desktop.
Inputs: name (required), fps, ratio, width, +1 more.
capcut_create_video_bridgeA
Orchestrates the Direct Video Track Bridge: creates a CapCut draft around a pre-rendered 60 FPS master video plate (Remotion/WebGL), separates multi-track audio, and auto-imports subtitles into editable tracks.
Inputs: project_name (required), video_plate_path (required), fps, ratio, +2 more.
capcut_delete_projectA
Deletes a CapCut project folder and unregisters it from CapCut. Requires explicit confirmation.
Inputs: confirm (required), project_name_or_id (required).
capcut_duplicate_projectA
Duplicates an existing CapCut project to a new draft with fresh IDs (ideal for creating variations or backups).
Inputs: new_name (required), source_project (required).
capcut_generate_previewA
Renders a fast proxy preview video (.mp4) of a CapCut project using ffmpeg without needing to export from the GUI.
Inputs: project_name_or_id (required), fps, width, height, +1 more.
capcut_get_media_infoA
Inspects video or audio file technical parameters (duration, width, height, fps, codec) using ffprobe.
Inputs: file_path (required).
capcut_get_projectA
Fetches the complete timeline structure, tracks, media materials, and duration of a CapCut project.
Inputs: project_name_or_id (required).
capcut_list_projectsA
Lists all CapCut video projects on this computer, including duration, resolution, track counts, and lock status.
Inputs: no named parameters.
capcut_open_appA
Launches CapCut Desktop on Windows or opens the project folder in Windows Explorer.
Inputs: project_name_or_id.
capcut_remove_clipB
Deletes a specific segment from a project track by its segment ID.
Inputs: segment_id (required), project_name_or_id (required).
capcut_set_clip_speedA
Sets playback speed multiplier (e.g. 0.5x slow-mo, 1.25x talking head, 2.0x time-lapse) with optional pitch preservation so voices do not sound like chipmunks.
Inputs: speed (required), segment_id (required), project_name_or_id (required), preserve_pitch.
capcut_set_clip_transformB
Adjusts scale, rotation, translation position (x, y), or opacity of an existing clip.
Inputs: segment_id (required), project_name_or_id (required), x, y, +3 more.
capcut_split_clipA
Splits a video, audio, or text clip into two linked segments at an exact timeline timestamp (the timeline razor / blade tool). Essential for cutting out pauses, pacing edits, or inserting B-roll.
Inputs: segment_id (required), project_name_or_id (required), split_time_seconds (required).
capcut_trim_clipB
Adjusts the timeline start time or duration of an existing segment by its segment ID.
Inputs: segment_id (required), project_name_or_id (required), new_start_seconds, new_duration_seconds.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 24 tools
Each tool targets a distinct action on a distinct entity (project, clip, audio, text, effect). The few related categories (text vs subtitles vs viral caption; audio clip vs sound effect vs fade) are clearly differentiated by descriptions. No two tools appear to do the same job.
All 24 tools follow a uniform `capcut_<verb>_<noun>` snake_case convention. Verbs are consistent (get, list, create, add, set, remove, split, etc.) and nouns clearly identify the target. No mixed casing or stylistic inconsistencies.
At 24 tools, the server is on the heavier side but the CapCut editing domain is broad enough to justify the count. Each tool serves a specific editing or project-management function, and there's no obvious redundancy. Slightly above the ideal 3-15 range but not bloated.
The tool surface covers project lifecycle (create, read, duplicate, delete), clip management (add, remove, trim, split, speed, transform, keyframe), and media additions (audio, text, subtitles, stickers, transitions, SFX). Some minor gaps like setting audio volume directly or a final export tool, but core editing workflows are supported and workarounds exist.
Maintenance
Related MCP Connectors
AI video editor your agent can drive: plan scenes, edit a multi-track timeline, and render MP4s.
Open-source AI video editor: cut, caption, clip and animate real Revline projects from your agent.
The agentic video editor for ChatGPT and Claude. Ask in your chat and it cuts, captions, adds music, titles and motion graphics on a real timeline you can open and adjust.
CapCut MCP server for ChatGPT, Claude and any AI agent: list drafts, export draft, add auto captions, share draft for review, invite members to a space, set member role, transfer editing permission and search templates in your own CapCut account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to CapCut yourself; Cotlet does not store your password and you need no CapCut API key. About the official CapCut API: Partly. CapCut has an official plugin for the ChatGPT desktop app that builds drafts and adds captions, effects and templates (capcut.com, checked 6 Nov 2026). Setup and FAQ: https://cotlet.dev/integrations/capcut-api-mcp-server
Related MCP Servers
- FlicenseNot gradedqualityFmaintenanceAutomates CapCut video editing through an HTTP/MCP API, enabling draft creation, material addition (video, audio, text, images), effects, and AI-powered enhancements via natural language.95-
- FlicenseAqualityDmaintenanceCreates and edits CapCut desktop drafts locally by writing project files, enabling timeline manipulation through MCP tools.7-
- AlicenseBqualityCmaintenanceEnables AI coding agents to programmatically assemble vertical videos and manage local CapCut Desktop drafts, including AI background removal, audio mastering to -14 LUFS or Demucs vocal isolation, music auto-ducking, punch zooms, karaoke captions, PiP proof overlays, hook badges, safe-zone linting, proxy previews, and ENβES cloning/dubbing. It outputs real CapCut draft JSON ready for review and export.172MIT
- AlicenseBqualityCmaintenanceEnables reading and editing CapCut desktop draft projects, including adding/moving/trimming/splitting clips, text, audio, images, filters, transitions, masks, keyframe animation, audio fades, stickers, setting transforms, validation, and saving with backups.28MIT