MCP Windows Screenshots

🚀 MCP Windows Screenshots

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

🚀 Quick Start

When using Claude Code in WSL2, sharing Windows screenshots used to be a hassle. This tool simplifies the process significantly. Just take a screenshot on Windows (Win+Shift+S), ask Claude to show your latest screenshot, and Claude will instantly access and display it.

✨ Features

• Simplified Screenshot Sharing: Eliminates the need to navigate complex file paths when sharing Windows screenshots with Claude Code in WSL2.
• Automatic Screenshot Access: Claude can automatically find and view the latest screenshots.
• List Recent Screenshots: Allows you to ask Claude to display recent screenshots with timestamps and sizes.
• Check Screenshot Directories: Enables you to ask Claude to show all configured screenshot directories.

📦 Installation

Prerequisites

• Windows 10/11 with WSL2
• Node.js 18+ in WSL2
• Claude Code CLI installed

Steps

Simply run this command in your WSL2 terminal:

claude mcp add windows-screenshots -s user \
  -e "WINDOWS_USERNAME=YourWindowsUsername" \
  -e "MCP_SCREENSHOT_DIRS=/mnt/c/Users/YourWindowsUsername/Pictures/Screenshots" \
  -- npx mcp-windows-screenshots@latest

Replace YourWindowsUsername with your actual Windows username.

Example

For a user named "john" with screenshots in OneDrive:

claude mcp add windows-screenshots -s user \
  -e "WINDOWS_USERNAME=john" \
  -e "MCP_SCREENSHOT_DIRS=/mnt/c/Users/john/OneDrive/Pictures/Screenshots" \
  -- npx mcp-windows-screenshots@latest

Restart Claude Code after installation, and you're ready to go.

💻 Usage Examples

Basic Usage

Have Claude look 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 use mcp__windows-screenshots__list_screenshots to display your recent screenshots with timestamps and sizes.

Check Screenshot Directories

Ask Claude: "Which directories are you checking for screenshots?" Claude will use mcp__windows-screenshots__list_directories to show all configured paths.

📚 Documentation

Configuration

Environment Variables

• WINDOWS_USERNAME: Your Windows username (defaults to WSL username)
• MCP_SCREENSHOT_DIRS: Custom screenshot directory. For multiple directories, separate with semicolons: /path/1;/path/2

Default Search Locations

The tool automatically searches these common locations:

• /mnt/c/Users/[username]/Pictures/Screenshots
• /mnt/c/Users/[username]/Pictures
• /mnt/c/Users/[username]/OneDrive/Pictures/Screenshots
• /mnt/c/Users/[username]/OneDrive/Pictures 2/Screenshots 1
• /mnt/c/Users/[username]/Documents/Screenshots
• /mnt/c/Users/[username]/Desktop
• /mnt/c/Users/[username]/AppData/Local/Temp

Troubleshooting

No screenshots found

1. Verify your Windows username is correct.
2. Ask Claude to "list screenshot directories" to see which paths are being searched.
3. Ensure your screenshots are saved in one of the searched directories.
4. Set a custom directory with MCP_SCREENSHOT_DIRS if needed.

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.

Environment variables not working

Make sure you're using the claude mcp add command with -e flags as shown in the installation section.

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

This project is licensed under the MIT License © rubinsh.