PlugWiki
AutoClip logo

AutoClip MCP Server: Setup for Claude Code, Cursor and Other Apps

OfficialLocal
GetPyPIautoclip-mcpzhouxiaoka/autoclip

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.

Install AutoClip MCP

Claude Code

  1. 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. 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_output

  • Checks 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_status

  • Cuts 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_video

  • Starts 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_job

  • Checks 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_status

  • Shows 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_project

  • Lists recent projects

    Lists recent AutoClip projects. It shares the data folder with the desktop app.

    Try: “Show my last 10 AutoClip projects.”

    Files · list_projects

  • Shows 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_providers

  • Checks 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_environment

  • Renders 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_clip

  • Posts 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_clip

  • Checks 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_status

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-onlyNo read-only switch is documented.
Talks toThe 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 keysAUTOCLIP_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

WebsiteGitHubPyPIOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 3
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.