
AutoClip MCP Server: Setup for Claude Code, Cursor and Other Apps
Lets Claude or Cursor cut a long video into short clips with covers and captions for TikTok, Reels, Shorts and more, and post them for you.
This is the AutoClip app's own server. It runs on your computer, cuts and renders video locally with FFmpeg, and calls the AI model you choose to find the best moments. A local model such as Ollama keeps everything on your machine, while a cloud model gets your transcript. The model key is optional if the AutoClip desktop app already has one. Posting needs a separate Upload-Post account.
Good for
- Creators who turn podcasts and interviews into short vertical clips
- Social media managers who post the same video to several platforms
- Developers who script batch clipping from an agent
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install AutoClip MCP
Claude Code
- 1
Copy this prompt.
Add the AutoClip MCP server to Claude Code. Run this command: claude mcp add autoclip -- uvx autoclip-mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python), FFmpeg and FFprobe on PATH.
Needs uv, FFmpeg and FFprobe on your PATH. The first run downloads dependencies and can take a minute, so raise the client start-up timeout if it times out. Set AUTOCLIP_API_KEY in the server env only if the desktop app has no saved model key.
Built from the package data we hold. Not yet tested by us.
Tools
Turns a long video or link into short clips for chosen platforms
Starts a background job that makes videos, covers and captions for platforms such as douyin, tiktok, reels or shorts. The source can be a local file or a YouTube or Bilibili link.
Try: “Make TikTok and Shorts clips from ~/Videos/interview.mp4.”
Runs code ·
start_quick_outputChecks progress and collects the finished clips
Shows progress and the finished videos, covers and captions for each platform. Ask for the publish kit to get a ZIP.
Try: “How far along is project abc123? Give me the publish kit when it is done.”
Files ·
get_quick_output_statusCuts a local video into clips and waits until it is done
Runs the older full clipping job on a local video and reports progress. It can take minutes to tens of minutes. You can pick the model provider.
Try: “Clip ~/Videos/talk.mp4 and keep only the best segments.”
Runs code ·
clip_videoStarts the older clip job in the background
Starts clipping and returns a project ID straight away, for clients that time out on long calls.
Try: “Start a clip job for ~/Videos/talk.mp4.”
Runs code ·
start_clip_jobChecks an older clip job
Reports progress, stage and estimated time for a job started with the background clip tool.
Try: “What is the status of project abc123?”
Read ·
get_job_statusShows the clips of a finished project
Returns the clips with titles, times, scores and file paths, plus the output folder.
Try: “List the clips from project abc123.”
Files ·
get_projectLists recent projects
Lists recent AutoClip projects. It shares the data folder with the desktop app.
Try: “Show my last 10 AutoClip projects.”
Files ·
list_projectsShows which AI models it can use
Lists the cloud model providers and local presets such as Ollama and LM Studio, and which one is active.
Try: “Which model providers can AutoClip use?”
Read ·
list_providersChecks that ffmpeg and the model are ready
Checks ffmpeg, the Whisper speech tool and the model connection before you start a job.
Try: “Check that AutoClip is set up correctly.”
Runs code ·
check_environmentRenders one clip ready to post
Renders a clip as a vertical 9:16 video with burned-in subtitles and a title card, using a platform preset. The same settings reuse a cached file.
Try: “Export clip 3 of project abc123 for Shorts.”
Runs code ·
export_clipPosts a clip to social platforms
Renders a clip and posts it through the Upload-Post service to platforms such as TikTok, Instagram, YouTube, Facebook and X. It can schedule a post. It needs an Upload-Post API key and profile.
Try: “Post clip 3 to TikTok as private.”
Write ·
publish_clipChecks whether a post went live
Shows whether each platform post is pending, done or failed, with links.
Try: “Did my last post go through?”
Network ·
get_publish_statusLists your Upload-Post accounts
Lists the Upload-Post profiles and connected platforms, and whether publishing is set up.
Try: “Which accounts can I post to?”
Network ·
list_publish_profilesStops a running render
Stops the ffmpeg work for one project, clears its temporary files and marks the job cancelled. Videos that already finished are kept.
Try: “Cancel project abc123, it is taking too long.”
Runs code ·
cancel_jobLists the editing styles you can ask for
Returns the editing styles the template option accepts: editorial, street and classic.
Try: “Which clip styles can I choose?”
Read ·
list_stylesUsed by the assistant behind the scenes
Shows the installed version
Returns the AutoClip CLI and MCP version number.
Try: “Which AutoClip version is installed?”
Read ·
get_version
From the official docs
Permissions
medium risk · 4 things to watch
Medium risk
The assistant can create video files on your computer and, if you set an Upload-Post key, post clips to your social accounts. Leave the Upload-Post key unset unless you want posting, and try private posts first.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can post videos to your social accounts
The publish tool sends clips to platforms through Upload-Post. Ask the assistant to use private or scheduled posts first, and only set the Upload-Post key when you want posting. github.com
It writes video files to disk and runs FFmpeg
Jobs create projects and rendered files in the AutoClip data folder. Check the output folder size, since long videos take space. github.com
Cloud models see your transcript
With a cloud provider, text from your video goes to that provider, and cloud models are billed by use. Use a local model such as Ollama to avoid this. github.com
Sends anonymous usage events
Tool name, client name, version, run time and success are sent to PostHog. Paths, file names and keys are not. It is off when analytics is false in privacy.json. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch is documented. |
|---|---|
| Talks to | The AI model provider you pick (cloud providers get transcript text). Upload-Post, when you publish. YouTube or Bilibili, when the source is a link. Anonymous usage events unless analytics is off in the data folder |
| Sign-in and keys | AUTOCLIP_API_KEY is optional and set as an environment variable. The Upload-Post key can be saved with the CLI or set as UPLOAD_POST_API_KEY. |
Questions
Is the AutoClip MCP server official?
Yes. It ships from the AutoClip repository and is the server for the AutoClip app and CLI.
What do I need installed?
Python 3.10 or newer through uv, plus FFmpeg and FFprobe on your PATH. Redis is not needed for the local CLI.
Does it need an API key?
A model key is optional. Set AUTOCLIP_API_KEY, or reuse the key saved in the AutoClip desktop app. Posting needs a separate Upload-Post key.
Can I run it fully offline or free?
The software is free and MIT licensed. The README says cloud models are billed by use. The tool text says you can use Ollama on your machine to avoid that cost.
Can it post to my accounts by itself?
Only if you set up an Upload-Post key and profile. Then the publish tool can post and schedule clips on the platforms connected there.
Is the list of 16 tools complete?
Yes for the current release. The cancel and list-styles tools sit behind a flag called mcp_v2_tools, which is on by default. Set AUTOCLIP_FLAGS=mcp_v2_tools=off to hide them. The older clip and publish tools are marked deprecated in the tool list.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
autoclip-mcp- Registry
- PyPI
- Transport
- stdio
- Auth
- None
- Version
- 1.5.7.post1
- License
- MIT
- Last commit
- Oct 31, 2026
- Open issues
- 16
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com