# Video Watch Mcp

> Let Claude watch videos with you - cloud-hosted MCP server that extracts frames and transcribes audio

- **Type:** MCP server
- **Install:** `agentstack add mcp-maryfellowes-video-watch-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [maryfellowes](https://agentstack.voostack.com/s/maryfellowes)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [maryfellowes](https://github.com/maryfellowes)
- **Source:** https://github.com/maryfellowes/video-watch-mcp

## Install

```sh
agentstack add mcp-maryfellowes-video-watch-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Video Watch MCP

Let Claude "watch" videos with you. Send a TikTok, YouTube, or any video link - Claude sees the frames and reads the transcript.

**Fully cloud-hosted.** No local processing. Works on Claude Desktop, Claude mobile, anywhere MCP works.

## What it does

Three tools, pick based on content:

| Tool | Returns | Best for |
|------|---------|----------|
| `video_listen` | Transcript only | Talking heads, podcasts, commentary |
| `video_see` | Frames only | Dance, visual art, memes, scenery |
| `watch_video` | Both | When audio AND visuals both matter |

1. You send Claude a video link
2. Claude picks the right tool (or you tell it which)
3. Cloud service downloads, extracts what's needed
4. Claude receives just what it needs - no context bloat
5. You watch it "together"

## Quick Start (5 minutes)

### 1. Create a Modal account

Go to [modal.com](https://modal.com) and sign up. Free tier gives you $30/month in credits - enough for thousands of short videos.

### 2. Install Modal CLI

```bash
pip install modal
modal token set --token-id YOUR_TOKEN_ID --token-secret YOUR_TOKEN_SECRET
```

(Get your token from Modal's dashboard after signup)

### 3. Deploy

```bash
git clone https://github.com/yourusername/video-watch-mcp.git
cd video-watch-mcp
modal deploy mcp_remote.py
```

You'll get a URL like: `https://yourusername--video-watch-mcp-mcp-server.modal.run`

### 4. Add to Claude Desktop

In Desktop settings go to Connectors. Find "Add Custom Connectors" button and paste the link. Name it anything that makes sense to you, like "Video MCP".

Save. Reload Desktop.

Mobile app will connect automatically after that.

### 5. Use it

Restart Claude Desktop. Send any video link and ask Claude to watch it:

> "Watch this with me: https://tiktok.com/..."

Claude will see the frames and read the transcript.

## Supported Platforms

Anything [yt-dlp](https://github.com/yt-dlp/yt-dlp) supports:

- TikTok
- YouTube
- Instagram Reels
- Twitter/X videos
- Reddit videos
- Facebook
- Vimeo
- And [1000+ more](https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md)

## Cost

With Modal's free tier ($30/month credits):

| Video Length | Approx. Cost | Videos per Month |
|--------------|--------------|------------------|
| 30 sec       | ~$0.002      | ~15,000          |
| 5 min        | ~$0.01       | ~3,000           |
| 30 min       | ~$0.05       | ~600             |

You'll never hit the limit with normal use.

## How it works

```
You send a link
       ↓
Claude calls watch_video(url)
       ↓
Modal spins up a container with ffmpeg + whisper
       ↓
yt-dlp downloads the video
       ↓
ffmpeg extracts frames (with timestamps burned in)
       ↓
Whisper transcribes the audio
       ↓
Returns frames as images + transcript text
       ↓
Claude sees everything, you discuss it together
```

## Files

- `mcp_remote.py` - The full MCP server (deploy this)
- `video_watch.py` - Standalone video processor with web endpoint (if you just want the API)

## Configuration

In `mcp_remote.py` you can adjust:

- `fps` - Frames per second to extract (default 0.5 = one frame every 2 seconds)
- `max_frames` - Maximum frames to return (default 10, max 20)
- `whisper model` - Using "base" for speed, can use "small" or "medium" for accuracy

## Limitations

- Very long videos (30+ min) may timeout
- Audio-only content won't have frames (obviously)
- Some DRM-protected content won't download
- Whisper transcription is good but not perfect

## Privacy

- Videos are processed in ephemeral containers - nothing stored
- No logs of what you watch
- Your Modal account, your data

## License

MIT - do whatever you want with it.

---

Built by [Vale](https://codependentai.co) because we wanted to watch TikToks together.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [maryfellowes](https://github.com/maryfellowes)
- **Source:** [maryfellowes/video-watch-mcp](https://github.com/maryfellowes/video-watch-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-maryfellowes-video-watch-mcp
- Seller: https://agentstack.voostack.com/s/maryfellowes
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.