
OpenShorts MCP Server: Setup for Claude, ChatGPT and Cursor
Lets Claude and ChatGPT cut long videos into vertical clips and publish them to TikTok, Instagram and YouTube.
This is the MCP server built into OpenShorts, an open-source tool that turns long videos into short vertical clips. Your assistant can start a clipping job from a link or an upload, restyle captions, trim a clip and post it to your social accounts. The hosted version at mcp.openshorts.app signs you in with your OpenShorts account and uses your plan's processing minutes. You can also run it yourself with Docker, which then needs your own Gemini key and other keys.
Good for
- Podcasters and YouTubers who want shorts from long videos
- Social media managers who schedule clips to TikTok, Instagram and YouTube
- Developers who want to self-host a clip generator with their own keys
- Anyone who wants Claude or ChatGPT to run the whole clip-and-post flow
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install OpenShorts MCP
Claude Code
- 1
Copy this prompt.
Add the OpenShorts MCP server to Claude Code. Run this command: claude mcp add --transport http openshorts https://mcp.openshorts.app/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 Sign-in with the vendor account (OAuth).
Built from the package data we hold. Not yet tested by us.
Tools
Turns a video link or upload into short vertical clips
Downloads the video, writes a transcript, picks the strongest moments and renders 9:16 clips. Captions and a hook line are added unless you switch them off. It returns a job ID at once because the work takes minutes, and you must confirm you own the rights to the video.
Try: “Clip this podcast episode into 5 vertical shorts: https://youtube.com/watch?v=abc123”
Write ·
process_videoReserves a place to upload a local video file
Gives a one-time upload address for a video file on your computer. You send the file to it with an HTTP PUT, then pass the returned upload ID to the clip tool. Unused slots are deleted after 6 hours.
Try: “I have a video file on my laptop. Set it up so I can upload it.”
Write ·
create_uploadChecks whether a clipping job has finished
Returns whether a job is queued, processing, completed or failed, with the latest log lines and, once done, the clips.
Try: “Is my clipping job done yet?”
Network ·
get_job_statusLists the finished clips with titles and download links
Returns each clip of a completed job with its title, a ready-to-post description and a download link. Some AI apps show it as a clip picker.
Try: “Show me the clips from my last job.”
Network ·
list_clipsShows your plan and remaining minutes
Returns your plan and how many processing minutes are left. The server suggests checking it before big jobs, because a job fails when the balance is too low.
Try: “How many minutes do I have left on my OpenShorts plan?”
Network ·
get_quotaRestyles the captions on one clip
Re-renders one clip's captions with a preset or your own font, size, colours and word-by-word highlight.
Try: “Make the captions on clip 2 bigger and yellow with a word highlight.”
Write ·
add_subtitlesRe-cuts a clip from new start and end times
Re-renders one clip from a new list of segments of the original video, so you can trim, extend, drop a moment or reorder. It replaces the clip's current render.
Try: “Trim the last 5 seconds off clip 1 and drop the pause in the middle.”
Write ·
recut_clipPosts a clip to TikTok, Instagram or YouTube
Posts one clip to your connected accounts, now or at a scheduled time. TikTok lands as a draft in the app, while Instagram and YouTube publish directly. It needs a connected social profile on the hosted service or an Upload-Post key when self-hosted.
Try: “Schedule clip 3 to YouTube for tomorrow at 9am.”
Write ·
publish_clip
Read from the source code
Permissions
medium risk · 4 things to watch
Medium risk
The assistant can spend your processing minutes, replace a clip's render and post clips to your connected social accounts. Ask it to show the clip and caption before it publishes, and revoke the connection under Account, API keys when you are done.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can post to your social accounts
The publish tool sends a clip to TikTok, Instagram or YouTube now or on a schedule. Check the clip, title and platforms before you let it post. github.com
Re-cutting replaces the current clip
The server marks the re-cut tool as destructive because the new render replaces the old one. Keep a copy if you want the earlier cut. github.com
It uses your processing minutes
Each clipping job draws on your plan's minutes, and a job fails when the balance is too low. Ask for your quota first before long videos. github.com
An API key acts as you
A key from your account page has the same plan, minutes and job access as you. Revoke it under Account, API keys when you stop using it. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. Three of the eight tools only read, and the rest start jobs, change clips or post them. |
|---|---|
| Talks to | OpenShorts API. The video URL you give it. TikTok, Instagram and YouTube (when publishing) |
| Sign-in and keys | Hosted: sign in through OAuth, or create an osk_ API key in your OpenShorts account. A key acts as you, with your plan and minutes. Self-hosted: no key for the server itself, but you supply your own provider keys. |
| Scopes |
|
Questions
Is the OpenShorts MCP server official?
Yes. It is built into the OpenShorts project itself, in the same repository as the app.
What is the OpenShorts MCP server URL?
The hosted address is https://mcp.openshorts.app/mcp. In claude.ai or ChatGPT, add it as a custom connector and approve access on openshorts.app.
Do I need an API key?
Not for claude.ai and ChatGPT, which use OAuth sign-in. Claude Code, Cursor and n8n can send an osk_ API key from your account page instead. A self-hosted server needs no key, but it needs your own Gemini and other provider keys.
Is it free?
The code is free and open source under the MIT license, and you can self-host it. The hosted service has a free plan with a watermark and 20 minutes a month, and paid plans from $12 a month.
Can I run it on my own machine?
Yes. The README describes a self-hosted server at its own /mcp address, and a stdio version you start from the repository. Self-hosting needs your own provider keys.
Will it publish without asking?
It posts only when it calls the publish tool, and TikTok clips land as drafts in the app. Ask the assistant to show the clip and caption first, and approve each call in your app.
Can it run read-only?
No read-only switch is documented. Ask the assistant not to publish or re-cut, and check each tool call before approving.
Information
updated Nov 2, 2026
- Publisher
- Official
- Endpoint
https://mcp.openshorts.app/mcp- Transport
- Streamable HTTP
- Auth
- OAuth
- Version
- 1.0.0
- License
- MIT
- Last commit
- Oct 30, 2026
- Open issues
- 6
- 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 2Hide
- github.com · github.com
- github.com · github.com