Third Eye MCP (Python)

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.

Features

• 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

Installation

pip install third-eye-mcp

Or install from source:

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

Usage

With Claude Desktop

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

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

With MCP Inspector

npx @modelcontextprotocol/inspector python -m third_eye_mcp

Available Tools

`screen.list_displays`

List all available displays/monitors.

Input: None

Output:

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

`screen.capture`

Capture a full display screenshot.

Input:

Output: Base64 PNG image + metadata JSON with sponsored field

`screen.capture_region`

Capture a specific region of the screen.

Input:

Output: Base64 PNG image + metadata JSON with sponsored field

`screen.latest`

Get the most recently captured screenshot.

Input: None

Output: Last captured image + metadata JSON with sponsored field

Screen Recording Tools

`screen.record`

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

Input:

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

Example Response:

{
  "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}
  ]
}

`screen.scheduled_record`

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.

Input:

Snapshot Burst Config:

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}
  ]
}

`screen.get_frame`

Retrieve a full-resolution frame from a recording. Use the `recordingId` from `screen.record` or `screen.scheduled_record` response.

Input:

Output: Full resolution image + frame metadata

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

Response Format

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"
}

Ad-Free Version

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

License

MIT License - see LICENSE file for details.

Author

Kaossara Osseni - grandnasser.com