Skip to main content
Glama
chunlea

screenshot-mcp

by chunlea
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

screenshot-mcp

A cross-platform MCP (Model Context Protocol) server for capturing screenshots. Designed for agent-based native application testing.

Also available as a Claude Code plugin with screenshot testing guidance.

Features

  • List Windows: Get all visible windows with IDs, titles, and bounds

  • List Displays: Get all available monitors/displays

  • Screenshot Window: Capture a specific window by ID or title

  • Screenshot Screen: Capture an entire display

  • Screenshot Region: Capture a specific screen region

Installation

No installation required - use directly with npx or bunx.

Usage

Configure in Claude Code

Add to your MCP settings (~/.claude/settings.json):

{ "mcpServers": { "screenshot": { "command": "bunx", "args": ["screenshot-mcp"] } } }

Or with npx:

{ "mcpServers": { "screenshot": { "command": "npx", "args": ["-y", "screenshot-mcp"] } } }

Run Standalone

# Using bunx (recommended) bunx screenshot-mcp # Using npx npx -y screenshot-mcp

MCP Tools

list_windows

List all visible windows.

// Response [ { "id": "1234", "title": "VS Code", "app": "Code", "bounds": { "x": 0, "y": 25, "width": 1920, "height": 1055 } } ]

list_displays

List all available displays.

// Response [ { "id": 1, "name": "Built-in Retina Display", "primary": true, "bounds": { "x": 0, "y": 0, "width": 2560, "height": 1600 } } ]

screenshot_window

Capture a specific window.

// Parameters { "window_id": "1234" } // or { "window_title": "VS Code" } // optional: save to file { "window_id": "1234", "save_dir": "/path/to/screenshots" }

screenshot_screen

Capture the entire screen.

// Parameters (all optional) { "display_id": 1, "save_dir": "/path/to/screenshots" }

screenshot_region

Capture a specific region.

// Parameters { "x": 100, "y": 100, "width": 800, "height": 600 } // optional: save to file { "x": 100, "y": 100, "width": 800, "height": 600, "save_dir": "/path/to/screenshots" }

Platform Support

Platform

Status

macOS

Supported

Windows

Planned

Linux

Planned

Configuration (Plugin Settings)

Create .claude/screenshot.local.md in your project to set a default save directory:

--- default_save_dir: /Users/yourname/Desktop/screenshots ---

When this file exists, Claude will automatically use this directory for saving screenshots.

Note: Add .claude/*.local.md to your .gitignore.

Requirements

  • macOS: Requires Screen Recording permission (System Settings > Privacy & Security > Screen Recording)

  • Runtime: Bun v1.0+ or Node.js 18+

As Claude Code Plugin

Install as a plugin to get the screenshot-testing skill:

# Install from npm npm install -g screenshot-mcp claude plugin add screenshot-mcp # Or use local development claude --plugin-dir /path/to/screenshot-mcp

The skill provides guidance on:

  • Effective screenshot testing workflows

  • Comparison testing strategies

  • Multi-display testing

  • Electron app testing examples

License

MIT

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chunlea/screenshot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server