Screenshot MCP Server

A Model Context Protocol (MCP) server that enables natural language screenshot capture on macOS using FastMCP.

Features

Full Desktop Screenshots: Capture the entire desktop with optional delay
Window Screenshots: Interactive window selection for capturing specific applications
Area Screenshots: Interactive area selection for capturing custom regions
Screenshot Management: List and manage saved screenshots
Automatic Organization: Screenshots saved to ~/Desktop/mcp-screenshots/

Installation

Clone the repository:

git clone https://github.com/your-username/screenshot-mcp.git
cd screenshot-mcp

Create and activate a virtual environment:

python3 -m venv venv
source venv/bin/activate  # On macOS/Linux

Install dependencies:

pip install -r requirements.txt

Testing

Run the test script to verify everything is working:

python test_server.py

Configuration

Add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "screenshot": {
      "command": "/path/to/screenshot-mcp/venv/bin/python",
      "args": ["/path/to/screenshot-mcp/server.py"],
      "env": {}
    }
  }
}

Replace /path/to/screenshot-mcp with the actual path to your cloned repository.

Available Tools

`screenshot`

Captures a screenshot of the entire desktop.

Parameters:
- filename (optional): Custom filename for the screenshot
- delay (optional): Delay in seconds before capturing (default: 0)

`screenshot_window`

Captures a screenshot of a specific window through interactive selection.

Parameters:
- filename (optional): Custom filename for the screenshot

`screenshot_area`

Captures a screenshot of a selected area through interactive selection.

Parameters:
- filename (optional): Custom filename for the screenshot

`list_screenshots`

Lists recently saved screenshots with details.

Parameters:
- limit (optional): Maximum number of screenshots to list (default: 10)

Usage Examples

Once configured in Claude Desktop, you can use natural language commands like:

"Take a screenshot"
"Capture a screenshot with 3 second delay"
"Take a screenshot of this window"
"Screenshot just this area"
"Show me my recent screenshots"

Requirements

macOS (uses built-in screencapture command)
Python 3.8+
Claude Desktop application

File Structure

screenshot-mcp/
├── server.py          # Main MCP server implementation
├── test_server.py     # Test script for verification
├── requirements.txt   # Python dependencies
├── README.md         # This file
└── .gitignore        # Git ignore rules

Troubleshooting

Permission Issues: macOS may require screen recording permissions for the application running the server
Path Issues: Ensure the paths in the Claude Desktop configuration are absolute and correct
Virtual Environment: Make sure to use the Python interpreter from your virtual environment

License

This project is open source. Feel free to modify and distribute as needed.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

A Model Context Protocol server that enables natural language-driven screenshot capture on macOS, allowing users to take full desktop screenshots, capture specific windows, or select custom screen areas through Claude Desktop.

Related MCP Servers

@kazuph/mcp-fetch
kazuph
A
security
A
license
A
quality
Model Context Protocol server for fetching web content and processing images. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.
Last updated -
1
1,765
23
JavaScript
MIT License
AI Vision Debug MCP Server
samihalawa
A
security
A
license
A
quality
A Model Context Protocol server that provides AI vision capabilities for analyzing UI screenshots, offering tools for screen analysis, file operations, and UI/UX report generation.
Last updated -
26
1
JavaScript
ISC License
MCP Fetch
JeremyNixon
A
security
A
license
A
quality
Model Context Protocol server that enables Claude Desktop (or any MCP client) to fetch web content and process images appropriately.
Last updated -
1
23
MIT License
MCP-URL2SNAP
Abhi5h3k
A
security
F
license
A
quality
A lightweight Model Context Protocol (MCP) server that enables your LLM to capture screenshots of any specified URL and return only the access URL for the captured image. This tool simplifies the process of generating and sharing webpage snapshots, making it perfect for integrating visual capture ca
Last updated -
1
1
Python

View all related MCP servers

Screenshot MCP Server