Skip to main content
Glama
yushinna

Screenshot MCP Server

by yushinna
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python

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/

Related MCP server: Screeny MCP Server

Installation

  1. Clone the repository:

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

  1. Create and activate a virtual environment:

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

  1. 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

  1. Permission Issues: macOS may require screen recording permissions for the application running the server

  2. Path Issues: Ensure the paths in the Claude Desktop configuration are absolute and correct

  3. 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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

  • hithereiamaliff-mcp-nextcloudOAuth
    ai.smithery

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

    Cloud StorageFile SystemsWorkplace & Productivity
    238
  • GrabbitA
    live.grabbit

    Grabbit gives AI agents eyes on the web through a hosted MCP server. Send a public URL and get a pixel-perfect hosted image back, without maintaining Chromium, Playwright, or a browser fleet. Capture a full page, exact viewport, or single CSS selector as PNG, JPEG, or WebP. Grabbit handles cookie and consent banners, waits for JavaScript-heavy pages, blocks private and internal URLs, supports safe retries with idempotency keys, and delivers async results through signed webhooks. Completed captures include a CDN URL. Connect with OAuth 2.1 or an API key. Grabbit works with Claude, Cursor, Codex, and any MCP client. Live captures cost $0.002 each. The $50 annual plan includes 25,000 prepaid credits that never reset or expire. Free test keys return placeholder images, so you can wire up the integration before paying. Home: https://grabbit.live Docs: https://grabbit.live/screenshot-api Built by BrainGrid.

    Browser AutomationWeb Scraping
    52
  • TelnyxA
    com.telnyx.api

    The Telnyx MCP server is an official implementation of the Model Context Protocol that enables AI clients (like Claude Desktop, Cursor, and OpenAI Agents) to interact with Telnyx's telephony, messaging, and AI assistant APIs. It provides comprehensive capabilities including making and managing phone calls, sending SMS/MMS messages, purchasing and configuring phone numbers, creating AI assistants with custom instructions, managing cloud storage buckets, scraping and embedding website content, and handling integration secrets. The server exists as both a local implementation and a remotely hosted version, allowing developers to integrate real-world communication infrastructure directly into AI applications.

    CommunicationCloud PlatformsCloud Storage
    62
  • SnapRenderAOAuth
    com.snap-render.app

    SnapRender gives AI agents eyes on the web through a hosted MCP server. Send a public URL and get the page back as an image, a PDF or clean markdown, with no browser to run or maintain. Capture the viewport or the full page as PNG, JPEG, WebP or PDF, at desktop size or with a phone, tablet or laptop preset, in light or dark mode. Ads and cookie banners are removed by default, and you can hide elements or click one before the capture. extract_content reads the same page as markdown, text, article, links or metadata, so an agent can see a page and read it in one session. Made for monitoring and client work: batch up to 50 URLs in one job, check the cache for free before spending a capture, share signed links that render without an API key, and get webhooks when a batch finishes or a scheduled capture spots a change. Track competitors' pricing and landing pages, or send clients current screenshots of their sites. Connect with OAuth (Google, GitHub or email) or an API key. Works with Claude, ChatGPT, Cursor, VS Code and any MCP client. Free plan: 200 screenshots a month, no credit card. Paid plans from $9 a month for 2,000 up to $199 a month for 200,000. Home: https://snap-render.com Docs: https://snap-render.com/ai-agents

    Browser AutomationImage & Video ProcessingWeb Scraping
    1123

Related MCP Servers