How do I install MCP Screenshot?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does MCP Screenshot need an API key?

The publisher lists these environment variables: WAYLAND_DISPLAY, XDG_RUNTIME_DIR.

What transport does MCP Screenshot use?

MCP Screenshot runs locally over stdio.

MCP Screenshot

by io.github.KamaruSama

Take Wayland screenshots via grim/slurp. Full screen, region, or interactive crop.

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Local command

uvx mcp-screenshot==1.0.1

Credentials from the publisher

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.

Provider

Claude Code

WAYLAND_DISPLAY=<value> XDG_RUNTIME_DIR=<value> claude mcp add io.github.kamarusama-mcp-screenshot -- uvx mcp-screenshot==1.0.1

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.kamarusama-mcp-screenshot": {
      "command": "uvx",
      "args": [
        "mcp-screenshot==1.0.1"
      ],
      "env": {
        "WAYLAND_DISPLAY": "<value>",
        "XDG_RUNTIME_DIR": "<value>"
      }
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Related MCP

Related skills

View all

Questions

How do I install MCP Screenshot?: Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does MCP Screenshot need an API key?: The publisher lists these environment variables: WAYLAND_DISPLAY, XDG_RUNTIME_DIR.
What transport does MCP Screenshot use?: MCP Screenshot runs locally over stdio.
When was MCP Screenshot last checked?: Last checked 2026-10-16. Take Wayland screenshots via grim/slurp. Full screen, region, or interactive crop.

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 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

Support the project ❤

Ko-fi: https://ko-fi.com/kamaru

Contact

Portfolio / general: [email protected]
Commercial / licensing: [email protected]