OpusClip · mindstone — Claude Code MCP server: clips and setup
This MCP server connects OpusClip to an agent for turning long videos into clips, handling projects, and sending social posts.
claude mcp add --env OPUS_API_KEY=<OPUS_API_KEY> --env OPUS_API_TIMEOUT_MS=<OPUS_API_TIMEOUT_MS> --env OPUS_UPLOAD_TIMEOUT_MS=<OPUS_UPLOAD_TIMEOUT_MS> --env OPUS_BRIDGE_TIMEOUT_MS=<OPUS_BRIDGE_TIMEOUT_MS> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --transport stdio opus-video-clip -- npx -y @mindstone/mcp-server-opus-video-clipWhat OpusClip does
OpusClip connects an MCP host to the OpusClip API. An agent can submit a long-form video URL, upload a local video, inspect project status and clips, download an MP4, create a censor job, or work with clip collections.
The server exposes 22 tools covering projects, brand templates, collections, and social publishing. It can prepare platform-specific copy, publish a clip to a connected account, or schedule that post. The setup needs Node.js 20+, npm, and an OpusClip API key in OPUS_API_KEY.
Local video reads are restricted to MCP_WORKSPACE_PATH, or to the system temporary directory when that variable is unset. Download targets use the same sandbox; paths that escape it through .. or symlinks are rejected. Node.js 20+ is required for the server to start.
What it helps with
- turn a long video into short clips
- upload a local video and create a project
- check project status and retrieve generated clips
- group clips into a collection and export it
- schedule a clip for a connected social account
Example prompts for the agent
- Upload the video from the workspace to OpusClip and create a clipping project.
- Show the project status and list the clips it produced.
- Create platform-specific copy for this clip and schedule the post on a connected account.
How to install OpusClip
Platform CLI
claude mcp add --env OPUS_API_KEY=<OPUS_API_KEY> --env OPUS_API_TIMEOUT_MS=<OPUS_API_TIMEOUT_MS> --env OPUS_UPLOAD_TIMEOUT_MS=<OPUS_UPLOAD_TIMEOUT_MS> --env OPUS_BRIDGE_TIMEOUT_MS=<OPUS_BRIDGE_TIMEOUT_MS> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> --transport stdio opus-video-clip -- npx -y @mindstone/mcp-server-opus-video-clipReplace <…> with your own values
Platform CLI
codex mcp add opus-video-clip --env OPUS_API_KEY=<OPUS_API_KEY> --env OPUS_API_TIMEOUT_MS=<OPUS_API_TIMEOUT_MS> --env OPUS_UPLOAD_TIMEOUT_MS=<OPUS_UPLOAD_TIMEOUT_MS> --env OPUS_BRIDGE_TIMEOUT_MS=<OPUS_BRIDGE_TIMEOUT_MS> --env MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> -- npx -y @mindstone/mcp-server-opus-video-clipReplace <…> with your own values
Config file
{
"mcpServers": {
"opus-video-clip": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-opus-video-clip"
],
"env": {
"OPUS_API_KEY": "<OPUS_API_KEY>",
"OPUS_API_TIMEOUT_MS": "<OPUS_API_TIMEOUT_MS>",
"OPUS_UPLOAD_TIMEOUT_MS": "<OPUS_UPLOAD_TIMEOUT_MS>",
"OPUS_BRIDGE_TIMEOUT_MS": "<OPUS_BRIDGE_TIMEOUT_MS>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"opus-video-clip": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-opus-video-clip"
],
"env": {
"OPUS_API_KEY": "<OPUS_API_KEY>",
"OPUS_API_TIMEOUT_MS": "<OPUS_API_TIMEOUT_MS>",
"OPUS_UPLOAD_TIMEOUT_MS": "<OPUS_UPLOAD_TIMEOUT_MS>",
"OPUS_BRIDGE_TIMEOUT_MS": "<OPUS_BRIDGE_TIMEOUT_MS>",
"MCP_WORKSPACE_PATH": "<MCP_WORKSPACE_PATH>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e OPUS_API_KEY=<OPUS_API_KEY> -e OPUS_API_TIMEOUT_MS=<OPUS_API_TIMEOUT_MS> -e OPUS_UPLOAD_TIMEOUT_MS=<OPUS_UPLOAD_TIMEOUT_MS> -e OPUS_BRIDGE_TIMEOUT_MS=<OPUS_BRIDGE_TIMEOUT_MS> -e MCP_WORKSPACE_PATH=<MCP_WORKSPACE_PATH> opus-video-clip npx -y @mindstone/mcp-server-opus-video-clipReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpusClip
How do I install OpusClip in Claude Code?
Run claude mcp add mcp-server-opus-video-clip -e OPUS_API_KEY=<OPUS_API_KEY> -- npx -y @mindstone/mcp-server-opus-video-clip.
What does OpusClip do?
It gives an agent OpusClip tools for making short clips from long videos, handling projects and files, managing collections, and publishing clips.
What does OpusClip require?
You need Node.js 20+, npm, and an OpusClip API key. Local source videos and download destinations must stay inside MCP_WORKSPACE_PATH or the system temporary directory.
Similar MCP servers
MCP servers catalog →OpusClip by other authors comes first.
