Connect FrameCap to any AI agent

The MCP server is part of FrameCap Pro. Get FrameCap Pro, then follow the steps below.

What you need

• FrameCap Pro in your browser (Chrome, Edge or Brave), with an active license key.
• Node.js 18 or newer on your computer.

Claude Code

Run this once in your terminal:

claude mcp add --scope user framecap -- npx -y framecap-mcp@latest

On Windows:

claude mcp add --scope user framecap -- cmd /c npx -y framecap-mcp@latest

Codex

Run this once in your terminal:

codex mcp add framecap -- npx -y framecap-mcp@latest

On Windows:

codex mcp add framecap -- cmd /c npx -y framecap-mcp@latest

Cursor

Add to Cursor

Or paste the settings below into Cursor Settings, Tools & MCP, New MCP Server.

Any other AI agent

Antigravity, Gemini CLI, Windsurf, Claude Desktop, Cline, LM Studio and any other app with MCP servers: paste this into its MCP settings. In Antigravity: Manage MCP Servers, then View raw config. In VS Code, the list is called "servers" instead of "mcpServers".

{
  "mcpServers": {
    "framecap": {
      "command": "npx",
      "args": ["-y", "framecap-mcp@latest"]
    }
  }
}

On Windows:

{
  "mcpServers": {
    "framecap": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "framecap-mcp@latest"]
    }
  }
}

An agent without MCP

Any agent that can run commands can capture too, with any AI model. Add this line to its instructions:

To see a YouTube video, run: npx -y framecap-mcp capture <YouTube link> (options: npx -y framecap-mcp --help). Then read README.txt in the folder it prints.

Your agent can choose the part and the frames, for example:

npx -y framecap-mcp capture https://youtu.be/VIDEO_ID --start 1:30 --end 4:00 --gap 2

Use it

1. Ask your agent, for example: "Capture https://youtu.be/VIDEO_ID with FrameCap and follow the tutorial step by step." Or a video file on your computer: "Use FrameCap to capture C:\Videos\demo.mp4 every 1 second, with the English transcript."
2. The video opens in your browser. The first time, FrameCap asks Allow and capture. Click it once. After that, your agent's requests start on their own.
3. The capture lands in a framecap-captures folder in your project, and your agent reads it.

What your agent gets

• Frame sheets: pictures of the screen, up to 24 frames per picture, each with its time.
• transcript.txt: everything that was said, with times.
• README.txt: tells your agent how to read the files.

Your agent can also choose the part of the video, how often to take a frame, 1080p or 4K, Smart frames, PNG or JPG, and notes for Obsidian or Notion. For a video file (MP4, WebM, MOV, M4V, MKV or AVI), FrameCap writes down the words with speech-to-text in 60 languages, or uses a subtitle file. The first time, it downloads its speech tool once. The file stays on your computer. In a chat app that can't open files on your computer, your agent can get the transcript's text right in its reply.

If something doesn't work

Run this check in your terminal:

npx -y framecap-mcp --check

• "Connection closed" on Windows. Use the Windows command above, with cmd /c before npx.
• Nothing happens in the browser. FrameCap Pro must be installed and active in your default browser. If it's in another browser or profile, use FRAMECAP_BROWSER and FRAMECAP_PROFILE (below).
• Your browser asks where to save each file. Turn that off in its download settings, so FrameCap's file lands in your Downloads folder.
• "Activate FrameCap Pro". Click the FrameCap icon in your toolbar and paste your license key.

Optional settings

• FRAMECAP_BROWSER: the browser to open videos with, for example C:\Program Files\Google\Chrome\Application\chrome.exe
• FRAMECAP_PROFILE: the browser profile with FrameCap Pro, for example Profile 2. With both set, videos open in that profile, even when the browser is closed. npx -y framecap-mcp --check shows both for every profile that has FrameCap.
• FRAMECAP_DOWNLOADS: your browser's download folder, if you moved it.
• FRAMECAP_OUTPUT: where captures go (normally framecap-captures in your project).

Add a setting to the command with --env, for example on Windows:

claude mcp add --scope user framecap --env FRAMECAP_DOWNLOADS="D:\Downloads" -- cmd /c npx -y framecap-mcp@latest

Privacy

The MCP server runs on your computer. It opens the video in your browser and moves the result into your project. Nothing goes to FrameCap's servers. What your agent does with the files next follows its own rules. See the privacy policy.