WindowsCaptureMCP

An MCP (Model Context Protocol) server for capturing Windows screenshots and sharing them as base64-encoded images with LLMs.

Windows only — This package requires Windows and uses Win32 APIs for screen capture and window management.

Features

• List and filter visible windows
• Capture windows, full screen, or custom regions
• Low-quality preview images for quick verification before full capture
• Window management (focus, maximize, resize, move)
• Multi-display support
• PNG / JPEG / WebP output formats

Requirements

• Windows
• Python >= 3.11

Installation

# Using uvx (recommended)
uvx windows-capture-mcp

# Using pip
pip install windows-capture-mcp

MCP Client Configuration

Claude Code

Run the following command to register the MCP server:

# Register for all projects (user scope)
claude mcp add windows-capture-mcp -s user -- uvx windows-capture-mcp

# Register for the current project only (project scope)
claude mcp add windows-capture-mcp -s project -- uvx windows-capture-mcp

After registration, restart Claude Code to load the new MCP server. You can verify it is running with /mcp.

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "windows-capture-mcp": {
      "command": "uvx",
      "args": ["windows-capture-mcp"]
    }
  }
}

Available Tools

Information

Screen Capture (Full Quality)

All capture tools support format ("png", "jpeg", "webp") and quality (1-100) parameters.

Preview (Lightweight)

Preview images are JPEG at quality 30, resized to max 1280px on the longest side. Use these to verify capture targets before taking full-quality screenshots.

Window Management

Usage Example

1. list_windows(filter="Chrome")       → Find browser windows
2. preview_window(hwnd=12345)           → Quick preview to verify
3. capture_window(hwnd=12345)           → Full-quality capture

License

MIT