@clipy/mcp

Give your AI agent access to your Clipy screen recordings.

This is a Model Context Protocol (MCP) server. It lets Claude, Cursor, Windsurf, and other MCP-capable agents search your recordings and read their transcripts, AI summaries, and key moments — including the video frames of exactly what the speaker pointed at, delivered as inline images your agent can see. So you can do things like "read this bug-report recording and ship the fix" without leaving your agent.

Zero-setup alternative: every public Clipy share link is also agent-readable without this server — append .md (e.g. clipy.online/video/<id>.md) and any agent that can fetch a URL gets the summary, key moments with frames, and timestamped transcript. The MCP server adds private-library search, inline frame images, and one-call context bundles. More at clipy.online/for-agents.

It is read-only: it can never create, edit, or delete your recordings.

Setup

1. Create a free API key at https://clipy.online/settings/api-keys (it looks like clipy_sk_live_…). Copy it — it's shown only once.
2. Add the server to your MCP client.

Claude Code

The --scope user flag installs Clipy globally for every project. Without it, claude mcp add defaults to local scope (the current folder only):

claude mcp add --scope user clipy --env CLIPY_API_KEY=clipy_sk_live_xxx -- npx -y @clipy/mcp

Codex

This writes the server to your global ~/.codex/config.toml, so it's available in every Codex session:

codex mcp add clipy --env CLIPY_API_KEY=clipy_sk_live_xxx -- npx -y @clipy/mcp

Or add it to ~/.codex/config.toml by hand:

[mcp_servers.clipy]
command = "npx"
args = ["-y", "@clipy/mcp"]
env = { CLIPY_API_KEY = "clipy_sk_live_xxx" }

Claude Desktop / Cursor / Windsurf

Edit the matching user-level config (claude_desktop_config.json, ~/.cursor/mcp.json, or the Windsurf MCP config) directly:

{
  "mcpServers": {
    "clipy": {
      "command": "npx",
      "args": ["-y", "@clipy/mcp"],
      "env": { "CLIPY_API_KEY": "clipy_sk_live_xxx" }
    }
  }
}

Tools

Tool	What it does
search_recordings	Search your recordings by keyword (title + description).
list_recordings	List your most recent recordings.
get_recording	Metadata for one recording (status, duration, transcript/summary status).
get_transcript	The full timestamped transcript + plaintext.
get_summary	The AI summary: TL;DR, key points, action items.
wait_for_artifacts	Poll until a recording's transcript/summary finish processing.
download_recording	Download the MP4 locally so you can clip it or extract frames yourself (e.g. with ffmpeg).

All tools accept a recording's public id (the slug in its share URL) or the full https://clipy.online/video/<id> URL.

Config

Env var	Required	Default	Notes
CLIPY_API_KEY	yes	—	Your personal key from /settings/api-keys.
CLIPY_API_URL	no	https://clipy.online	Override for self-hosted/staging.

Privacy

Your key only ever reads your own recordings. Revoke it any time at /settings/api-keys. The server runs locally on your machine; your key is never sent anywhere except to the Clipy API over HTTPS.