@zyx1121/apple-screenshot-mcp
v0.1.2
Published
MCP server for Apple Screenshot — capture screen, window, or display via Claude Code
Downloads
320
Maintainers
Readme
█████╗ ██████╗ ██████╗ ██╗ ███████╗ ███████╗ ██████╗██████╗ ███████╗
██╔══██╗██╔══██╗██╔══██╗██║ ██╔════╝ ██╔════╝██╔════╝██╔══██╗██╔════╝
███████║██████╔╝██████╔╝██║ █████╗ ███████╗██║ ██████╔╝█████╗
██╔══██║██╔═══╝ ██╔═══╝ ██║ ██╔══╝ ╚════██║██║ ██╔══██╗██╔══╝
██║ ██║██║ ██║ ███████╗███████╗ ███████║╚██████╗██║ ██║███████╗
╚═╝ ╚═╝╚═╝ ╚═╝ ╚══════╝╚══════╝ ╚══════╝ ╚═════╝╚═╝ ╚═╝╚══════╝
███████╗███╗ ██╗███████╗██╗ ██╗ ██████╗ ████████╗
██╔════╝████╗ ██║██╔════╝██║ ██║██╔═══██╗╚══██╔══╝
█████╗ ██╔██╗ ██║███████╗███████║██║ ██║ ██║
██╔══╝ ██║╚██╗██║╚════██║██╔══██║██║ ██║ ██║
███████╗██║ ╚████║███████║██║ ██║╚██████╔╝ ██║
╚══════╝╚═╝ ╚═══╝╚══════╝╚═╝ ╚═╝ ╚═════╝ ╚═╝@zyx1121/apple-screenshot-mcp
MCP server for Apple Screenshot — capture screen, window, or display via Claude Code.
Install
claude mcp add apple-screenshot -- npx @zyx1121/apple-screenshot-mcpPrerequisites
- macOS with screencapture available
- Node.js >= 18
- Screen Recording permission may be required (System Settings > Privacy & Security > Screen Recording)
Tools
| Tool | Description |
|------|-------------|
| screenshot_capture | Take a screenshot on macOS (full screen, specific display, or interactive window selection) |
| screenshot_list_screens | List available screens/displays with resolution info |
Examples
"Take a screenshot" → screenshot_capture { mode: "fullscreen" }
"Capture a window" → screenshot_capture { mode: "window" }
"Screenshot display 2" → screenshot_capture { mode: "screen", screen: 2 }
"Save a screenshot to ~/Desktop/shot.png" → screenshot_capture { mode: "fullscreen", path: "~/Desktop/shot.png" }
"Take a screenshot without the cursor" → screenshot_capture { mode: "fullscreen", hide_cursor: true }
"Capture screen as JPEG" → screenshot_capture { mode: "fullscreen", format: "jpg" }
"List all displays" → screenshot_list_screens {}Limitations
- macOS only (uses
screencapturecommand)
License
MIT — say cheese
