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.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →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
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →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.