Capture Win

Provides Windows listing by Space and window capture for MCP clients on macOS.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "huegli-capture-win-mcp": {
      "command": "capture-win-mcp",
      "args": []
    }
  }
}

This MCP server captures macOS windows and Spaces context so you can programmatically list windows and capture screenshots through an MCP client. It enables automation and AI-assisted workflows to interact with your desktop from scripts or assistants.

How to use

You run a local MCP server and connect a client that supports MCP to it. The server exposes tools to list all macOS windows organized by Space and to capture screenshots of specific windows. Use these capabilities to build workflows, automate window management, or feed window images to an AI assistant for analysis.

How to install

Prerequisites you need before installing the MCP server.

macOS (tested on macOS 15+)
Python 3.12 or higher
yabai window manager

Install yabai

brew install koekeishiya/formulae/yabai
yabai --start-service

Install the MCP server

Choose one of the installation methods below and run the commands exactly as shown.

# Method 1: Install from GitHub (Recommended)
uv pip install git+https://github.com/huegli/capture-win-mcp.git

Method 1 continuation

pip install git+https://github.com/huegli/capture-win-mcp.git

Method 2: Install from PyPI

# Using uv
uv pip install capture-win-mcp

# Using pip
pip install capture-win-mcp

Method 3: Install from Source (For Development)

# Clone the repository
git clone https://github.com/huegli/capture-win-mcp.git
cd capture-win-mcp

# Create virtual environment
uv venv  # or: python3 -m venv venv
source .venv/bin/activate

# Install in editable mode
uv pip install -e .  # or: pip install -e .

Development setup optional notes

If you plan to develop on the server, you can run it directly from source after installing the package in editable mode.

Available tools

list_windows

Lists all macOS windows organized by Space with details such as window ID, title, app name, and geometry.

capture_window

Captures a screenshot of a specific window by its window ID, with an option to include the window shadow.