screen-mcp

A lightweight MCP server that lets AI assistants capture screenshots on macOS.

---

📦 Download

Download the latest binary from Releases.

# Extract and install
tar -xzf screen-mcp-v*.tar.gz
mv screen-mcp /usr/local/bin/

# Add to Claude Code
claude mcp add screen-mcp /usr/local/bin/screen-mcp

Or build from source:

cargo install --git https://github.com/tomohiro-owada/screen-mcp

🎯 Features

• Window List — Get all open windows with IDs, app names, and titles
• Window Capture — Screenshot specific windows by ID
• Full Screen — Capture the entire desktop
• Single Binary — No dependencies, just one ~2MB executable

🔧 Tools

Tool	Description
get_windows	List all open windows with IDs
get_screenshot	Capture full desktop
get_screenshot_window	Capture a specific window by ID
clear	Clear stored screenshots

⚙️ Setup

Claude Code

claude mcp add screen-mcp /usr/local/bin/screen-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "screen-mcp": {
      "command": "/usr/local/bin/screen-mcp"
    }
  }
}

⚠️ Requirements

• macOS 10.15+
• Screen Recording permission (System Settings → Privacy & Security → Screen Recording)

📄 License

MIT