clipmaster-mcp

MCP (Model Context Protocol) server that exposes the ClipMaster public API as tools, so Claude Desktop, Claude Code, and any MCP client can ingest videos, monitor processing, browse clips, trigger exports, and schedule posts.

• Talks ONLY to the public REST API (https://api.clipmaster.app/api/v1) with the user's API key — no database access, no internal services.
• Ingestion is URL-only by design (streaming a local file through an LLM tool call is impractical). Account management (keys, billing, OAuth connects) is excluded; the API rejects those routes for key auth anyway.

Requirements

• Python 3.10+
• A ClipMaster API key (paid plans): web app → Settings → API access

Install

From this repo checkout:

pipx install ./clipmaster-mcp
# or, without installing:
uvx --from ./clipmaster-mcp clipmaster-mcp

Configure

*Instead of the env var you can put the key in ~/.config/clipmaster/key — this keeps it out of client config files and shell history:

mkdir -p ~/.config/clipmaster && printf '%s' 'cm_live_...' > ~/.config/clipmaster/key && chmod 600 ~/.config/clipmaster/key

The env var wins when both are set.

Claude Code

claude mcp add clipmaster -e CLIPMASTER_API_KEY=cm_live_... -- clipmaster-mcp

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "clipmaster": {
      "command": "clipmaster-mcp",
      "env": { "CLIPMASTER_API_KEY": "cm_live_..." }
    }
  }
}

Tools

Development

python3 -m venv .venv && .venv/bin/pip install -e ./clipmaster-mcp pytest
.venv/bin/pytest clipmaster-mcp/tests -q