ClipToWSL

ClipToWSL is a Model Context Protocol (MCP) server that enables AI coding agents like Claude Code to read Windows clipboard contents from within WSL (Windows Subsystem for Linux). This allows seamless access to clipboard data including text and images when working in WSL environments.

Quick Start: For easy installation, download therelease packagewhich includes pre-built binaries and automated setup scripts.

Download therelease packagewhich includes pre-built binaries:

# 1. Download and extract the release package wget https://github.com/CarlosGtrz/ClipToWslMcp/releases/download/v1.0.0/clip-to-wsl-mcp-v1.0.0.zip unzip clip-to-wsl-mcp-v1.0.0.zip cd clip-to-wsl-mcp-v1.0.0/ # 2. Run the automated installer ./install.sh # 3. Follow the configuration instructions printed by the installer

# 1. Clone the repository git clone <repository-url> cd ClipToWslMcp # 2. Install build dependencies sudo apt update sudo apt install gcc-mingw-w64-x86-64-posix g++-mingw-w64-x86-64-posix npm install -g typescript # 3. Install Node.js dependencies cd mcp-server && npm install && cd .. # 4. Build the project ./create-release.sh # Creates optimized release build

{ "mcpServers": { "clip-to-wsl": { "command": "node", "args": ["/path/to/release/index.js"], "env": { "CLIPBOARD_EXE_PATH": "/path/to/release/clipreader.exe" } } } }

{ "mcpServers": { "clip-to-wsl": { "command": "node", "args": ["/full/path/to/ClipToWslMcp/mcp-server/dist/index.js"], "env": { "CLIPBOARD_EXE_PATH": "/full/path/to/ClipToWslMcp/clipboard-reader/clipreader.exe" } } } }

Important: Replace the paths with your actual installation directory. The automated installer creates aclaude-config-example.jsonfile with the correct paths for your system.

- CLIPBOARD_EXE_PATH: Path to the Windows clipboard reader executable (required)

Once configured, theread_clipboardtool will be available in Claude Code:

When you copy text to the Windows clipboard, you can ask Claude Code:

- "What's in my clipboard?"
- "Read the clipboard content"
- "Use the text from my clipboard"

When you copy an image (screenshot, copied image, etc.), Claude Code can:

- View and analyze the image
- Describe what's in the image
- Process the image data

Theread_clipboardtool accepts an optionalformatparameter:

- "auto"(default): Automatically detect and return the best available format
- "text": Force reading as text only
- "image": Force reading as image only

cd clipboard-reader echo '{"jsonrpc":"2.0","method":"read_clipboard","id":1}' | ./clipreader.exe

cd mcp-server npm start # In another terminal, send MCP requests to test functionality

- Ensure MinGW-w64 is properly installed:x86_64-w64-mingw32-g++ --version
- Check that all paths in configuration are absolute paths

- Verify the executable path is correct and accessible
- Check that the Windows executable has proper permissions
- Ensure the executable can run (test with direct execution)

- Verify the configuration path and syntax
- Check Claude Code logs for MCP server startup errors
- Restart Claude Code after configuration changes

- Ensure you're running from within WSL with access to Windows clipboard
- Check that Windows clipboard contains data
- Verify no other applications are blocking clipboard access

# Check if executable was built successfully ls -la clipboard-reader/clipreader.exe # Test executable directly echo '{"method":"read_clipboard","id":1}' | /path/to/clipreader.exe # Check MCP server startup cd mcp-server && node dist/index.js # Monitor process communication ps aux | grep clipreader

The MCP server provides console logging for debugging:

- Process startup and shutdown events
- Health check results
- Error messages and stack traces
- Request/response communication logs

ClipToWslMcp/ ├── clipboard-reader/ # C++ Windows executable │ ├── src/ │ │ ├── main.cpp # JSON-RPC communication │ │ ├── clipboard.cpp # Windows clipboard access │ │ ├── clipboard.h │ │ ├── base64.cpp # Base64 encoding │ │ └── base64.h │ ├── Makefile # Build configuration with optimizations │ └── clipreader.exe # Built executable (after build) ├── mcp-server/ # TypeScript MCP server │ ├── src/ │ │ ├── index.ts # Main server │ │ ├── clipboard-manager.ts # Process management │ │ └── types.ts # Type definitions │ ├── dist/ # Compiled JavaScript (after build) │ ├── package.json │ └── tsconfig.json ├── release/ # Ready-to-use release package │ ├── index.js # Compiled MCP server │ ├── clipreader.exe # Optimized Windows executable │ ├── package.json # Runtime dependencies only │ ├── install.sh # Automated installer │ └── README.md # Installation instructions ├── create-release.sh # Automated release builder ├── shared/ # Shared configuration │ └── config.json # Claude Code config template └── docs/ # Documentation

- Install development dependencies (MinGW-w64, Node.js, TypeScript)
- Cross-compile the Windows executable using MinGW-w64
- Build the TypeScript MCP server
- Use./create-release.shto create optimized release package
- Test integration between components

The automated release builder creates a distribution-ready package:

- Builds optimized Windows executable with size optimization
- Compiles TypeScript to JavaScript
- Creates release package with runtime dependencies only
- Generates installation scripts and documentation
- Produces a standalone package ready for distribution
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a pull request

- The Windows executable runs with minimal permissions
- Clipboard data is processed locally without network transmission
- Process isolation prevents access to sensitive WSL environment
- Input validation prevents injection attacks
- Resource limits prevent memory exhaustion

- Memory usage: Optimized for large images with streaming processing
- Startup time: Process reuse minimizes initialization overhead
- Image handling: Efficient PNG compression and Base64 encoding
- Error recovery: Automatic process restart on failures

MIT License - see LICENSE file for details.

For issues, bug reports, or feature requests, please create an issue in the repository.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

CLI token optimizer and AI context generator with built-in MCP server. Scans codebases to extract routes, schema, components, and dependencies 9x–13x token reduction for Claude Code, Cursor, Copilot, Codex, and Windsurf.

Context optimization for AI coding assistants — 99% token savings via 14 content-aware summarizers, 3-layer search, and progressive disclosure. No LLM dependency.

Runtime continuity layer MCP for AI coding agents, providing persistent workspace state and session context across tools and runs.

MCP server for coding agents that returns structured, low-noise tool output to reduce tokens/cost.

A comprehensive MCP server with 30+ developer tools including JSON/XML formatting, UUID generation, hashing, encoding, regex testing, color conversion, JWT decoding, timestamp conversion, and more.

10 zero-auth developer utilities (JSON, regex, JWT, base64, hash, UUID, timestamp, YAML/JSON, cron) exposed as MCP tools,companion to lit-forge.com.

A server for storing and retrieving personalized coding patterns from a local JSONL file.

A persistent development partner that prevents context drift and maintains project memory across all development sessions.

Provides preset prompt templates as tools to assist clients like Cursor and Windsurf in executing various tasks.

Programmatically manage Visual Studio Code settings using AI assistants and automated tools.