Claude Video Vision

claude-video-vision

An MCP server and Claude Code plugin that let the agent watch video: frames via ffmpeg and audio transcription via Gemini, local Whisper or OpenAI

MCP server

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • Runs ffmpeg and yt-dlp and downloads Whisper models
  • The cloud backends send audio to Gemini or OpenAI
All reasons and checks

jordanrendric/claude-video-vision

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/claude-video-vision

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal

claude mcp add --transport stdio claude-video-vision -- npx -y claude-video-vision@latest

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "claude-video-vision": {
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "claude-video-vision": {
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"claude-video-vision","type":"stdio","command":"npx","args":["-y","claude-video-vision@latest"]}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "claude-video-vision": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the servers key.

Run in a terminal

codex mcp add claude-video-vision -- npx -y claude-video-vision@latest

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.claude-video-vision]
command = "npx"
args = ["-y", "claude-video-vision@latest"]

If the file already exists, append the block to the end.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "claude-video-vision": {
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "claude-video-vision": {
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "claude-video-vision": {
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "claude-video-vision": {
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "claude-video-vision": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the mcp key.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "claude-video-vision": {
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "claude-video-vision": {
      "command": "npx",
      "args": [
        "-y",
        "claude-video-vision@latest"
      ]
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

You will need: Node.js

Checked against the repository on Sep 24, 2026, commit ac47d1f.

Text for your agent

In Claude Code: /plugin marketplace add https://github.com/jordanrendric/claude-video-vision, then /plugin install claude-video-vision. The server installs via npx on first use. Then run the wizard /claude-video-vision:setup-video-vision and pick a backend.

Other ways from the author
/plugin marketplace add https://github.com/jordanrendric/claude-video-vision
/plugin install claude-video-vision

The server installs via npx on first use.

This is third-party code. Review the repository files before installing.

What it does

The MCP server extracts video frames via ffmpeg and processes audio with one of three backends: Gemini API, local Whisper or OpenAI API. The agent receives frames as images and audio transcription with timestamps; the server is a perception layer, not an interpretation layer. Local files and YouTube URLs are supported, downloaded with yt-dlp and preferring captions. It exposes six tools: video_info, video_analyze, video_watch, video_detail, video_configure, video_setup. The plugin adds a /watch-video slash command, a setup wizard and a video-perception skill that guides the agent's workflow. Frame options and the Whisper model are configurable.

Who it is for. For developers and analysts who need the agent to understand video content.

Good fit when

  • You want the agent to watch a local video or a YouTube clip and answer about its content
  • You need audio transcription with timestamps alongside frames
  • You need to analyze a bug report or a screen recording frame by frame

Not a fit when

  • You only need text analysis without video
  • You cannot install ffmpeg, or yt-dlp for YouTube URLs

Example request

Watch this video and tell me what happens in the first minute: ~/Downloads/demo.mp4

Limitations

Needs Node.js 20 or newer and ffmpeg, plus yt-dlp for YouTube URLs. The Gemini API backend needs a GEMINI_API_KEY, the OpenAI backend needs an OPENAI_API_KEY and paid per-usage billing, and both services are unavailable from Russia without a VPN. The local whisper.cpp backend runs offline and keyless, with Whisper models downloaded on first use. At the first release it was tested on macOS with the local backend.

How to disable. Remove the claude-video-vision plugin via /plugin or drop the server from the client's MCP configuration.

MCP

Transport
stdio
Authentication
not required
Environment variables
Environment variables
GEMINI_API_KEY
secret
Gemini API key for the Gemini backend, has a free tier.
OPENAI_API_KEY
secret
OpenAI key for the OpenAI backend, paid per usage.

Security check

  • Runs ffmpeg and yt-dlp and downloads Whisper models
  • The cloud backends send audio to Gemini or OpenAI

README in short

The README describes a Claude Code plugin with an MCP server that gives the agent video perception. The server extracts frames via ffmpeg and transcribes audio via the Gemini API, local Whisper or OpenAI API, returning frames and text with timestamps. Local files and YouTube URLs via yt-dlp are supported. The plugin installs with /plugin commands, the server is pulled via npx, and configuration runs through the /setup-video-vision wizard. There are six MCP tools and a /watch-video slash command. MIT licensed.

FAQ

Can it work without cloud keys?

Yes. The local whisper.cpp backend transcribes audio offline, with no keys and no cost. Keys are needed only by the Gemini and OpenAI backends.

Is YouTube supported?

Yes. You can pass a URL directly; the server downloads the clip with yt-dlp and prefers captions, using the audio backend only when captions fall short.

Editors’ pick

Skills and CLI from HeyGen: the agent writes HTML compositions and renders them into MP4 videos, captions, motion graphics and decks

SkillMedium risk53.9KRepository stars

Blender MCP

MCP for Blender

Editors’ pick

An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender

MCP serverHigh risk29.5KRepository stars
Editors’ pick

Official Remotion skills for making videos in React: compositions, animation, captions, maps and rendering

SkillLow risk4.8KRepository stars

Agentic video studio for Claude Code, Cursor and Codex: script, voiceover, images, stock footage, music, subtitles and render

WorkflowMedium risk61.8KRepository stars
Foxx AIClaude Video Vision

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.