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).
1 maintainer
Metadata
1 maintainer
Release files for mcp-screenshot 1.0.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_screenshot-1.0.1.tar.gz | 4.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_screenshot-1.0.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 8.7 kB
Release files / mcp_screenshot-1.0.1.tar.gz
| Download URL | mcp_screenshot-1.0.1.tar.gz |
|---|---|
| Size | 4.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eebf9d7906a97d95c3b85e0df520752ca18a7660aaa70d0616d192bb8e183f85
|
|
BLAKE2b-256 checksum How to use checksums |
2aefc0b3919e78744381d65c2a81ebd27f100e5d35d3a67a6ab884f14dbcd2cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / mcp_screenshot-1.0.1-py3-none-any.whl
| Download URL | mcp_screenshot-1.0.1-py3-none-any.whl |
|---|---|
| Size | 4.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
afc09aea23ec6030a8cbadf87ef655f38ab752d0189dcc949b95d164adecdd5d
|
|
BLAKE2b-256 checksum How to use checksums |
337f240acbcf1a9de6a58d66eb76f05ece95cc598cad84babc9f4c5c30bd41fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
