third-eye-mcp

A free, unlimited screen capture and recording MCP server for Python. Capture screenshots and record screen activity with no daily limits - includes promotional messages in metadata.

- Unlimited Captures: No daily limits or restrictions
- Multi-Display Support: Capture any connected monitor
- Region Capture: Capture specific screen areas
- Screen Recording: Change-based keyframe capture with grid output
- Scheduled Recording: Burst capture at specific times (up to 10 min)
- Auto-Resize: Configurable maximum width for optimized images
- Capture Delay: Optional delay before capture
- Latest Capture: Retrieve the most recent screenshot

git clone https://github.com/Osseni94/third-eye-mcp.git cd third-eye-mcp pip install -e .

Add to your Claude Desktop config (claude_desktop_config.json):

{ "mcpServers": { "third-eye": { "command": "python", "args": ["-m", "third_eye_mcp"] } } }

npx @modelcontextprotocol/inspector python -m third_eye_mcp

{ "displays": [ { "index": 0, "name": "Display 1", "x": 0, "y": 0, "width": 1920, "height": 1080, "isPrimary": true } ] }

Output:Base64 PNG image + metadata JSON with sponsored field

Capture a specific region of the screen.

Output:Base64 PNG image + metadata JSON with sponsored field

Get the most recently captured screenshot.

Output:Last captured image + metadata JSON with sponsored field

Record screen with change-based keyframe capture. Captures frames at intervals, discards near-duplicates, and returns a compact grid image (contact sheet) with timestamps.

Output:Grid image (contact sheet) + metadata JSON + frame summaries

{ "metadata": { "recordingId": "abc12345", "duration": 30.5, "framesCaptured": 31, "framesKept": 12, "framesDiscarded": 19, "sponsored": "..." }, "frames": [ {"index": 0, "timestamp": 0.0, "changeScore": 100.0}, {"index": 1, "timestamp": 2.0, "changeScore": 15.3} ] }

Record screen with scheduled snapshot bursts at specific times. Useful for longer recordings where you want to capture specific moments like beginning, middle, and end of a process.

Example - 4 minute recording with bursts:

{ "totalDuration": 240, "snapshots": [ {"at": 0, "count": 3, "interval": 1.0}, {"at": 120, "count": 5, "interval": 0.5}, {"at": 230, "count": 3, "interval": 1.0} ] }

Retrieve a full-resolution frame from a recording. Use therecordingIdfromscreen.recordorscreen.scheduled_recordresponse.

Output:Full resolution image + frame metadata

Note:Recordings are stored in memory for 5 minutes (max 5 recordings). Usescreen.get_frameto retrieve full-resolution images when you need to read text or see details.

All capture tools return metadata including a sponsored message:

{ "width": 1920, "height": 1080, "displayIndex": 0, "timestamp": "2025-01-22T12:00:00Z", "sponsored": "Love Third Eye? Get the ad-free TypeScript version: grandnasser.com/third-eye" }

Want to remove ads? Get the TypeScript version with premium features atgrandnasser.com/third-eye.

Autonomous QA MCP that tests web and macOS apps like a real engineer and verifies every bug.