# Screencast MCP

> Screencast MCP is a free MCP server for design and media. Let a coding agent record the Windows screen, review frames and edit video with ffmpeg. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Windows, CLI
- **Website:** https://tmhsdigital.github.io/screencast-mcp/
- **Repository:** https://github.com/tmhsdigital/screencast-mcp
- **MCP Registry name:** io.github.TMHSDigital/screencast-mcp
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

Where tools like OBS expect a person at the controls, here the agent starts and stops recordings, samples the footage into frames it can look at, and edits the result through typed tools. Recording can target the whole desktop, one monitor, a window by title or a pixel region, with optional system audio and an input event log of clicks, scrolling and typing bursts. Nothing records on its own; every capture is an explicit tool call.

The README counts 59 tools behind ffmpeg and ffprobe, grouped into capture, watch, edit, produce and audio toolsets that can be limited with SCREENCAST_TOOLSETS. Edits include trimming, cropping, redaction, annotation, zooming toward clicks, and export for GitHub or social. Capture is Windows 10 or 11 only; watch and edit tools run anywhere ffmpeg runs, and FFmpeg 8 is needed for transcription.

It has no cloud service or telemetry. Optional controls include allowed folders, a recording time cap and a confirmation prompt for every live capture. The licence is CC BY-NC-ND 4.0, free for non-commercial use.

## Features

- **Agent-driven recording:** Start, pause, stop and save replay buffers for screen or window capture.
- **Frame sampling:** Turn footage into frames the model can view, with scene-change mode.
- **Input event log:** Read clicks, scrolls and typing bursts with video timestamps.
- **ffmpeg edits:** Trim, crop, redact, annotate, zoom and export clips.
- **Capture guards:** Allowed folders, recording caps and optional confirmation prompts.
- **Toolset selection:** Load only the capture, watch, edit, produce or audio tools.

## Good for

- Record a bug reproduction and attach a GIF to a pull request
- Have the agent verify a UI change by watching its own recording
- Make a README demo clip with click highlights
- Redact sensitive regions before sharing a video
- Transcribe a recorded session

## Install

### Claude Code (Terminal)

```sh
claude mcp add screencast-mcp -- npx -y @tmhs/screencast-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "screencast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tmhs/screencast-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "screencast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tmhs/screencast-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "screencast-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tmhs/screencast-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "screencast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tmhs/screencast-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "screencast-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tmhs/screencast-mcp"
      ]
    }
  }
}
```

## Tools

- `start_recording`: Start a background screen recording
- `stop_recording`: Stop a recording and return the path and duration
- `delete_recording`: Delete a finished recording with its sidecars
- `pause_recording`: Pause a recording
- `resume_recording`: Resume a paused recording
- `save_replay`: Save the last N seconds of a replay buffer to an mp4
- `list_sessions`: List recording sessions
- `get_session`: Inspect one recording session
- `read_events`: Read input events of a recording
- `add_marker`: Mark a labelled moment on a recording
- `screenshot`: Capture one PNG of the screen, monitor, window or region
- `get_media_info`: Probe a media file with ffprobe
- `list_audio_devices`: List DirectShow audio devices
- `list_video_devices`: List DirectShow cameras
- `sample_frames`: Sample a recording into frames
- `transcribe`: Transcribe audio with whisper
- `doctor`: Report ffmpeg version, filters, devices and missing pieces

## FAQ

### Does it work on macOS or Linux?

Capture is Windows-only; watch, edit and produce tools run anywhere ffmpeg runs.

### What do I need installed?

Windows 10 or 11, Node.js 22+, and FFmpeg 8 or newer on PATH.

### Can I use it commercially?

The README states CC BY-NC-ND 4.0 and free for non-commercial use.

### How do I set it up in Claude Desktop?

Download the .mcpb file from the latest release, or run npx -y @tmhs/screencast-mcp setup.

### Is Screencast MCP free?

Yes. Screencast MCP is free to use.

### How do I add Screencast MCP to Claude Code?

Run this command in your terminal: claude mcp add screencast-mcp -- npx -y @tmhs/screencast-mcp

### What are the best alternatives to Screencast MCP?

The closest alternatives to Screencast MCP are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/screencast-mcp
