Skip to main content
Glama

MCP Windows Screenshots

by rubinsh

MCP Windows Screenshots

An MCP (Model Context Protocol) server that enables Claude to access Windows screenshots from WSL2. Perfect for seamlessly sharing screenshots with Claude Code without manual file navigation.

Why This Tool?

When using Claude Code cli in WSL2 or in Cursor/VSCode, sharing Windows screenshots requires navigating complex file paths like /mnt/c/Users/... or dragging the image to the terminal. Also, what if want to share the last 4 screenshots with Claude? this can become very cubersome. This tool simplifies the process to just:

  1. Take a screenshot on Windows (Win+Shift+S)
  2. Ask Claude to show your latest screenshot/s
  3. Claude instantly accesses and displays it

No more copy-pasting paths or navigating directories!

Key Features

  • Auto-detection: Automatically detects your Windows Screenshots folder location from the registry
  • Cross-platform: Works in both WSL2 and native Windows environments
  • Smart defaults: Falls back to common screenshot locations if custom paths aren't found
  • Zero configuration: Works out of the box for most users

Prerequisites

  • Windows 10/11 (with or without WSL2)
  • Node.js 18+
  • Claude Code CLI installed

Installation

Run this single command in your terminal (works in WSL2, Windows Terminal, PowerShell, or Command Prompt):

claude mcp add windows-screenshots -s user -- npx mcp-windows-screenshots@latest

That's it! Restart Claude Code and you're ready to go.

The tool will automatically:

  • Detect your environment (WSL2 or Windows)
  • Find your Windows Screenshots folder from the registry
  • Configure the appropriate paths

Usage

Once installed, Claude can use these tools:

View a Screenshot

Ask Claude: "Look at the latest screenshot"

Claude will automatically find it and look at the image.

List Recent Screenshots

Ask Claude: "Show me my latest screenshots"

Claude will display your recent screenshots with timestamps and sizes.

Check Screenshot Directories

Ask Claude: "Which directories are you checking for screenshots?"

Claude will show all configured paths.

How It Works

The tool automatically:

  1. Detects your environment (WSL2 vs native Windows)
  2. Queries Windows registry for your actual Screenshots folder location
  3. Searches common locations as fallback:
    • Your configured Screenshots folder (from Windows settings)
    • Pictures/Screenshots
    • OneDrive Pictures/Screenshots
    • Desktop
    • Documents/Screenshots
    • Temp folders

Troubleshooting

No screenshots found

  1. Ask Claude to "list screenshot directories" to see which paths are being searched
  2. Ensure your screenshots are saved in one of the searched directories
  3. If your screenshots are in a custom location, see Advanced Configuration below

Tool not available

  1. Restart Claude Code after installation
  2. Run claude mcp list to verify the server is installed
  3. Ensure you used -s user when adding the server

Advanced Configuration

Custom Screenshot Directories

If your screenshots are saved in a non-standard location, you can specify custom directories:

WSL2 with custom paths:
claude mcp add windows-screenshots -s user \ -e "MCP_SCREENSHOT_DIRS=/mnt/c/Users/john/CustomFolder;/mnt/c/Users/john/Desktop" \ -- npx mcp-windows-screenshots@latest
Windows with custom paths:
claude mcp add windows-screenshots -s user -e "MCP_SCREENSHOT_DIRS=C:\Users\john\CustomFolder;C:\Users\john\Desktop" -- npx mcp-windows-screenshots@latest

Environment Variables

  • WINDOWS_USERNAME: Override the auto-detected Windows username
  • MCP_SCREENSHOT_DIRS: Specify custom screenshot directories (semicolon-separated for multiple paths)

Manual Username Configuration

If the auto-detection doesn't find the correct username:

WSL2:
claude mcp add windows-screenshots -s user \ -e "WINDOWS_USERNAME=YourWindowsUsername" \ -- npx mcp-windows-screenshots@latest
Windows:
claude mcp add windows-screenshots -s user -e "WINDOWS_USERNAME=YourWindowsUsername" -- npx mcp-windows-screenshots@latest

Development

To contribute or modify this tool:

git clone https://github.com/rubinsh/mcp-windows-screenshots.git cd mcp-windows-screenshots npm install npm run build

License

MIT © rubinsh

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

local-only server

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

An MCP server that enables Claude to access Windows screenshots from WSL2, allowing users to easily share screenshots with Claude Code without manually navigating complex file paths.

  1. Why This Tool?
    1. Key Features
  2. Prerequisites
    1. Installation
      1. Usage
        1. View a Screenshot
        2. List Recent Screenshots
        3. Check Screenshot Directories
      2. How It Works
        1. Troubleshooting
          1. No screenshots found
          2. Tool not available
        2. Advanced Configuration
          1. Custom Screenshot Directories
          2. Environment Variables
          3. Manual Username Configuration
        3. Development
          1. License

            Related MCP Servers

            • -
              security
              A
              license
              -
              quality
              An MCP server that allows accessing and managing ledger files through Claude by providing account listing, balance checking, and transaction register viewing capabilities.
              Last updated -
              3
              GPL 3.0
              • Apple
            • A
              security
              A
              license
              A
              quality
              An MCP server that enables saving and sharing Claude Desktop conversations, allowing users to store chats privately or make them public through a web interface.
              Last updated -
              11
              MIT License
              • Apple
            • A
              security
              A
              license
              A
              quality
              An MCP server that enables Claude to interact with Twitter, allowing for posting tweets and searching Twitter content.
              Last updated -
              220
              290
              MIT License
              • Apple
            • A
              security
              A
              license
              A
              quality
              This MCP server provides tools for interacting with Cloudflare Browser Rendering, allowing you to fetch and process web content for use as context in LLMs directly from Cline or Claude Desktop.
              Last updated -
              5
              10
              MIT License
              • Apple

            View all related MCP servers

            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/rubinsh/mcp-windows-screenshots'

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