screenshot-mcp

> An MCP (Model Context Protocol) server that enables AI agents to capture screenshots of running application windows on Linux systems. Supports X11 and Wayland/KDE Plasma 6.

[](https://github.com/adityachauhan0/screenshot-mcp/stargazers) [](https://github.com/adityachauhan0/screenshot-mcp/network) [](https://opensource.org/licenses/MIT)

This MCP server provides AI agents with the ability to list all running application windows and capture screenshots of specific windows. It's designed for use with Claude, Cursor, and other MCP-compatible AI assistants.

Key Features:

• Lists all visible application windows with titles and process IDs
• Captures screenshots of any running window by ID
• Automatic platform detection (X11 or Wayland/KDE)
• Returns file paths for easy integration with AI workflows
• Graceful error handling with helpful install hints

# Arch Linux
sudo pacman -S xdotool imagemagick

# Ubuntu/Debian
sudo apt install xdotool imagemagick

# Fedora
sudo dnf install xdotool ImageMagick

# Arch Linux
sudo pacman -S grim xdotool  # xdotool for fallback window listing

# Ubuntu/Debian
sudo apt install grim wl-clipboard

# Fedora
sudo dnf install grim

• Python 3.10 or higher
• MCP SDK (mcp>=1.0.0)

# Clone the repository
git clone https://github.com/adityachauhan0/screenshot-mcp.git
cd screenshot-mcp

# Install in development mode
pip install -e .

# Or install dependencies only
pip install -r requirements.txt

Add to your MCP client configuration (e.g., Claude Desktop, Cursor):

{
  "mcpServers": {
    "screensh