Summary
Built for Wayland users who need Claude to capture and analyze what's on screen. Wraps grim and slurp to expose two tools: take_screenshot lets you grab the full display, a specific geometry, or launch an interactive region selector, while list_outputs enumerates your monitors via wlr-randr. Screenshots come back as base64 for inline analysis or get saved to disk. Setup requires pointing to your Wayland socket and runtime directory, so you'll need to configure WAYLAND_DISPLAY and XDG_RUNTIME_DIR when adding it. Works with Sway, Hyprland, and other wlroots compositors. If you're debugging UI issues or want Claude to see your desktop without manual uploads, this handles the capture layer.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
mcp-screenshot
MCP server for taking Linux / Wayland screenshots via grim and slurp.
Exposes 2 tools to capture the full screen, a selected region, or an interactive crop — returned inline as base64 or saved to disk.
Tools
| Tool | Purpose |
|---|---|
take_screenshot | Capture screen (full / geometry / interactive select) |
list_outputs | List available Wayland outputs / monitors |
Requirements
- Wayland compositor (Sway, Hyprland, etc.)
grim— screenshot toolslurp— interactive region selectorwlr-randr(optional) — forlist_outputs
Install on Arch Linux:
sudo pacman -S grim slurp wlr-randr
Install
claude mcp add screenshot -s user \
--env WAYLAND_DISPLAY=wayland-1 \
--env XDG_RUNTIME_DIR=/run/user/1000 \
-- /path/to/mcp-screenshot/.venv/bin/python /path/to/mcp-screenshot/server.py
Build the venv once:
cd /path/to/mcp-screenshot
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python mcp
Support the project ❤
- Ko-fi: https://ko-fi.com/kamaru
Contact
- Portfolio / general: k.kamarux@gmail.com
- Commercial / licensing: contact@likezara.com
Copyright © 2026 likezara™. All rights reserved. Developed by Kamaru (pen name).
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
WAYLAND_DISPLAY*Wayland display identifier (e.g. wayland-1). Required for grim to find the compositor.
XDG_RUNTIME_DIR*Wayland runtime directory (e.g. /run/user/1000). Required for socket lookup.