OpenClipDocs
Developers & agents

Connect over MCP

Add OpenClip's remote MCP server to Claude, Cursor, or any MCP client, with OAuth or a bearer token.

OpenClip's full remote MCP server exposes 31 tools for clipping, uploads, media utilities, UGC, account usage, and Brand management. It works in Claude, Cursor, Perplexity, and other clients that support remote MCP servers. The separate ChatGPT app endpoint exposes a curated set of 10 clipping tools. See MCP tools for both scopes.

The full server supports two authentication methods. Pick one.

The primary endpoint is:

https://openclip.app/mcp

It uses OAuth 2.1 with dynamic client registration, so there is no key to copy. Paste the URL into your client and sign in with your OpenClip account when prompted.

Claude Desktop / claude.ai: Settings → Connectors → Add custom connector → paste https://openclip.app/mcp → Connect → sign in.

Claude Code:

claude mcp add --transport http openclip https://openclip.app/mcp
# then run /mcp to sign in

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "openclip": { "url": "https://openclip.app/mcp" }
  }
}

Cursor runs the OAuth flow when it first connects. Other clients with a "custom connector" or "remote MCP server" option work the same way: paste the URL, sign in.

ChatGPT app endpoint

The OpenClip app for ChatGPT connects to:

https://openclip.app/mcp/app

It uses the same OAuth sign-in as the full server, but exposes only 10 reviewed clipping tools: account details, video submission and listing, processing and render status, clip listing and rendering, caption presets, supported providers, and transcripts.

Option 2: Bearer token

For header-only or programmatic clients that can't run an OAuth flow, use the token endpoint:

https://openclip.app/mcp/key

Generate a token at https://openclip.app/settings/connect ("Generate MCP token"). It is shown once, so store it safely. Send it as an Authorization: Bearer header on every request.

Claude Code:

claude mcp add --transport http openclip https://openclip.app/mcp/key \
  --header "Authorization: Bearer <token>"

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "openclip": {
      "url": "https://openclip.app/mcp/key",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Scopes

All three endpoints require the mcp:use scope. OAuth tokens for /mcp and /mcp/app request it automatically, and bearer tokens minted for /mcp/key include it. A token without it is rejected with a 403.

Verify the connection

Ask your assistant to call get_account. It returns your account email, team, and remaining credits. If that works, the connection is good; try "turn this YouTube video into clips" next.

Agent Skills

Skills teach your agent how to drive OpenClip well: the async polling loops, the upload gotchas, and the per-tool parameter reference. There are two ways to install them.

npx skills add OpenClip-App/agent-skills

This pulls the full published set from OpenClip-App/agent-skills and works with Claude Code, Codex, Cursor, and 70+ other agents. Alongside the umbrella openclip skill you get focused ones for clipping, captions, transcription, media conversion, video editing, thumbnails, background removal, repurposing, and UGC ads. Install only the ones you want.

Claude Code can install the skills and wire up the MCP server in one step instead:

/plugin marketplace add OpenClip-App/agent-skills
/plugin install openclip@openclip

Zip download

If you would rather not use Node, download the bundle at https://openclip.app/mcp/skill. It is a zip containing the umbrella skill's SKILL.md and reference.md. Unzip it into your agent's skills directory (for Claude Code: .claude/skills/openclip/).

Notes

  • Processing is asynchronous. Your agent submits work, then polls status tools; nothing is pushed to it.
  • The clipping pipeline needs credits, funded by a subscription or a running trial. A submission from a team with neither is accepted and parked: submit_video returns a pending_credits status instead of failing, and the video processes once the team is entitled. The full server's media utilities (transcribe, convert, edit, thumbnails, background removal) are free with just an account.
  • Manage or revoke your MCP token any time at https://openclip.app/settings/connect.

On this page