macos-screen-mcp — Give AI eyes on your macOS desktop

claude code — macos screen-aware mcp ▦▦

$ claude

# Start chatting — Claude automatically senses your desktop

> What's on my screen right now?

Calling get_desktop_state

Frontmost app: VS Code

Chrome tab: localhost:3210

Calling capture_screen

[Screenshot captured, analyzing...]

Calling get_browser_content

Active tab: localhost:3210/index.html

localhost:3210/index.html

⚡ Acme

Sign In

Please enter your details

email@example.com password Sign In

Terminal Claude Code runs here, auto-invokes MCP tools

Preview Live preview of generated artifacts

Toolbar 4 MCP tools

// Features

Give AI eyes on your macOS desktop. See, capture, and inspect — all through MCP.

🖥

get_desktop_state

Get the current desktop context: frontmost app, browser tab URLs and titles, window positions and sizes, screen resolution. Let Claude know what you're looking at.

📷

capture_screen

Capture screen content and return it as an image to Claude. Supports full screen, specific region, or frontmost window. Claude can literally see your screen.

🌐

get_browser_content

Inspect detailed browser state — active tab title and URL per window, optionally all tabs. Supports Chrome, Safari, and Arc.

👁

preview_file

Open generated artifacts (HTML, images, PDFs) in your default app, Chrome, or Quick Look so Claude can show you what it just made.

// Getting Started — one config, optional permission

Up and running in 30 seconds

1 Install

claude mcp add --transport stdio \
  macos-screen -- npx -y macos-screen-mcp

One command — Claude Code auto-downloads and registers the MCP server. Restart to activate.

2 Use

$ claude
> What's on my screen right now?
> What tabs do I have open in Chrome?
> Preview this HTML file for me

Claude automatically recognizes intent and invokes MCP tools to get desktop context and screenshots

3 Authorize (optional)

⚠ Screen Recording Permission

System Settings > Privacy & Security > Screen Recording
→ Enable for your terminal app

Only triggered on first screenshot. macOS prompts automatically — grant once, works forever