A
licenseA
qualityD
maintenanceA free, unlimited screen capture and recording MCP server for Python. Captures screenshots and records screen activity with no daily limits.
7
1
MIT
recit
by codedbytahir
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@recitcapture a screenshot of my desktop"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
recit
Record it. Agents see it.
Free, open-source screen recording CLI + MCP server for AI agents. Zero cost. 100% local. No cloud. No API keys.
Features
Screen Recording — Capture full screen, windows, or regions via ffmpeg
Screenshots — Instant PNG capture with JSON metadata output
MCP Server — 5 tools exposed via Model Context Protocol (stdio)
Frame Extraction — Scene-detection key frames for vision model analysis
Event Logging — JSONL event log synced to video clock (clicks, keystrokes, annotations)
Cross-Platform — macOS, Windows, Linux
$0 Cost — No APIs, no cloud, no hosting, no subscriptions
Related MCP server: video-capture-mcp
Quick Start
# For Claude Code
claude mcp add recit -- npx -y @zum-x/recit
# For Cursor / VS Code — add to mcp.json:
{
"mcpServers": {
"recit": {
"command": "npx",
"args": ["-y", "recit"]
}
}
}
# Prerequisites (both free)
brew install ffmpeg # macOS
sudo apt install ffmpeg # Ubuntu/Debian
winget install ffmpeg # WindowsCLI Usage
# Start recording
recit start [--output path] [--fps 15] [--json]
# Stop recording
recit stop <id> [--json]
# Capture screenshot
recit snap [--output path] [--json]
# Extract frames from video
recit frames <video> [--max 20] [--output dir]
# Check recording status
recit status [id]
# Start MCP server
recit mcpMCP Tools
Tool | Description |
| Start screen recording |
| Stop recording, get file path |
| Capture screenshot |
| Extract key frames from video |
| Get recording status or active count |
Architecture
AI Agent (Claude/Codex/Cursor)
│
│ stdio (stdin/stdout)
▼
recit MCP Server (Node.js, local)
│
│ child_process
▼
ffmpeg (free, local)
│
▼
.mp4 / .png saved to user's disk$0 spent. Nothing uploaded. Everything local.
Development
git clone https://github.com/codedbytahir/recit.git
cd recit
npm install
npm test # Run 43 tests
npm run build # Build TypeScriptTech Stack
Layer | Tool | Cost |
Recording | ffmpeg | $0 |
Agent Integration | MCP SDK (stdio) | $0 |
Distribution | npm | $0 |
Code Hosting | GitHub | $0 |
Runtime | Node.js | $0 |
Testing | Vitest | $0 |
License
Apache 2.0
This server cannot be deployed
Maintenance
ActivitySlowing
ResponsivenessNo issues
Related MCP Connectors
Screenshot and HTML render MCP server for AI agents
MCP server for Hailuo (MiniMax) AI video generation
MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.
MCP server for Wan AI video generation
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for screen recording on macOS, iOS Simulator, and Android, with key-frame extraction via ffmpeg, enabling AI agents to capture UI motion and transient visual states.121MIT
- AlicenseAqualityFmaintenanceProvides an MCP server for local low-power screen vision, enabling AI agents to perform OCR and UI detection on inaccessible screens (games, remote desktops) using NPU acceleration and system OCR.51MIT
- AlicenseNot gradedqualityDmaintenanceA Windows MCP server that enables AI agents to capture screenshots of open windows or the full desktop via stdio or HTTP.MIT