Claude MarketplacesSubmit
kamarusama avatar

Mcp Screenshot

kamarusama/mcp-screenshot

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.

tools
2
auth
Required
transport
STDIO
env vars
2
last updated
Apr 19, 2026
View on GitHub

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

take_screenshotCapture screen (full / geometry / interactive select)

Capture screen (full / geometry / interactive select)

No parameter schema in public metadata yet.

list_outputsList available Wayland outputs / monitors

List available Wayland outputs / monitors

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

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.

Readme

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

ToolPurpose
take_screenshotCapture screen (full / geometry / interactive select)
list_outputsList available Wayland outputs / monitors

Requirements

  • Wayland compositor (Sway, Hyprland, etc.)
  • grim — screenshot tool
  • slurp — interactive region selector
  • wlr-randr (optional) — for list_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

View the full README on GitHub

Details

Repository
github.com/kamarusama/mcp-screenshot
Package
mcp-screenshot
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from kamarusama