Screenshot MCP Server

An MCP server that provides screenshot capabilities for AI tools, allowing them to capture and process screen content.

Overview

This MCP server enables AI tools to take screenshots of the user's screen, making it possible for AI assistants to see and analyze what the user is looking at. The server handles image capture, compression, and delivery in a format suitable for AI processing.

Features

Take full screen screenshots
Automatic JPEG compression for efficient transfer
Base64 encoded image data for reliable transmission
Support for both stdio and SSE transport modes
Configurable image quality and optimization
Simple command-line interface for testing

Installation

From Source

# Clone the repository
git clone https://github.com/codingthefuturewithai/screenshot_mcp_server.git
cd screenshot_mcp_server

# Install using UV (recommended)
uv pip install -e .

# Or using pip
pip install -e .

Available Tools

take_screenshot

Description: Takes a screenshot of the user's screen and returns it as a JPEG image.

Parameters: None

Returns:

Image content in JPEG format, base64 encoded

Usage

The server can be used in two ways:

Command Line Client

# Take a screenshot and save it to a file
screenshot_mcp_server-client output.jpg

Programmatic Usage

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async with stdio_client(StdioServerParameters(command="screenshot_mcp_server-server")) as (read, write):
    async with ClientSession(read, write) as session:
        result = await session.call_tool("take_screenshot")
        # Process the screenshot data...

Requirements

Python 3.10 or later (< 3.13)
Dependencies:
- mcp >= 1.0.0
- pyautogui >= 0.9.54
- Pillow >= 10.0.0
Operating Systems: Linux, macOS, Windows

Configuration

The server supports two transport modes:

stdio (default): For command-line usage
SSE: For web-based applications, runs on port 3001 by default

To run in SSE mode:

screenshot_mcp_server-server-sse --port 3001

License

This project is licensed under the MIT License.

Author

Tim Kitchens (timkitch@codingthefuture.ai)

Install Server

HTTP connection URL

security – no known vulnerabilities

license - not found

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

take_screenshot

Enables AI tools to capture and process screenshots of a user's screen, allowing AI assistants to see and analyze what the user is looking at through a simple MCP interface.

Related MCP Servers

ScreenshotOne MCP Serverofficial
screenshotone
A
security
A
license
A
quality
An official MCP server implementation that allows AI assistants to capture website screenshots through the ScreenshotOne API, enabling visual context from web pages during conversations.
Last updated -
1
3
28
TypeScript
MIT License
webdev-mcp
zueai
A
security
F
license
A
quality
An MCP server that provides web development tools including taking screenshots of screens, enabling AI agents to capture and analyze visual content during development.
Last updated -
2
437
8
TypeScript
webdev-mcp
fefergrgrgrg
A
security
A
license
A
quality
An MCP server providing web development tools such as screen capturing capabilities that let AI agents take and work with screenshots of the user's screen.
Last updated -
2
437
15
MIT License
Peekaboo MCP
steipete
A
security
A
license
A
quality
A macOS utility that captures screenshots and analyzes them with AI vision, enabling AI assistants to see and interpret what's on your screen.
Last updated -
3
10,773
490
MIT License

View all related MCP servers

Screenshot MCP Server