yfzhou0904/chatgpt-handoff-mcp

ChatGPT Handoff MCP Server

A minimal MCP (Model Context Protocol) server that enables seamless handoff of prompts from Claude Code to ChatGPT. This tool simply copies your prompt to the clipboard so you can paste it directly into ChatGPT.

Features

• Single MCP tool: ask_chatgpt with flexible prompt input
• Dual transports: stdio (default) and HTTP server modes
• Latest MCP protocol: Auto-negotiates to highest supported version (currently 2025-06-18)
• Cross-platform clipboard: Works on macOS, Windows, and Linux
• Browser integration: Auto-send to ChatGPT using deeplinks (for shorter prompts)
• Minimal and fast: No file I/O, no notifications, just clipboard copying

Installation

Recommended: Go Install

go install .

This installs the chatgpt-handoff binary to your $GOPATH/bin (usually ~/go/bin), which should be in your $PATH.

From Source

git clone https://github.com/yourorg/chatgpt-handoff
cd chatgpt-handoff
go build -o chatgpt-handoff

Install Binary

Place the chatgpt-handoff binary somewhere in your $PATH, such as /usr/local/bin/.

Platform Dependencies

Linux users: Install a clipboard utility:

# Ubuntu/Debian
sudo apt install xclip

# Or alternatively
sudo apt install xsel

Windows/macOS: No additional dependencies required.

Configuration

Claude Code Integration

Add to your Claude Code MCP configuration (typically ~/.config/claude-code/settings.json):

{
  "mcpServers": {
    "chatgpt-handoff": {
      "command": "chatgpt-handoff"
    }
  }
}

Note: If you installed via go install ., the binary should be available as chatgpt-handoff in your PATH.

Command Line Options

• --http: Enable HTTP server mode instead of stdio
• --port <number>: HTTP server port (default: 8080, only with --http)

Example configurations:

Stdio mode (default):

{
  "mcpServers": {
    "chatgpt-handoff": {
      "command": "chatgpt-handoff"
    }
  }
}

HTTP server mode:

# Start server
./chatgpt-handoff --http --port 8080

# Configure Claude Code to connect to HTTP server
{
  "mcpServers": {
    "chatgpt-handoff": {
      "transport": {
        "type": "http",
        "baseUrl": "http://localhost:8080/mcp"
      }
    }
  }
}

Usage

Once configured, ask Claude Code to research topics:

Example prompts:

• "Do deep web research on quantum computing trends in 2024"
• "Research competitive analysis of AI coding assistants"
• "Investigate the latest developments in renewable energy storage"

Claude will automatically call the ask_chatgpt tool, which copies your prompt to the clipboard and may open ChatGPT in your browser for short prompts.

Tool Schema

The MCP tool accepts a simple prompt parameter:

{
  "prompt": "string (required) - The research prompt to send to ChatGPT"
}

Response

The tool returns a simple text message indicating success or failure.

How It Works

1. You provide a prompt to Claude Code
2. Claude Code calls the ask_chatgpt tool
3. Your prompt is copied to the clipboard
4. If the prompt is short enough, ChatGPT opens in your browser
5. You paste the prompt into ChatGPT (if it didn't auto-open)

That's it! Simple and reliable.

Manual Testing

You can test the MCP server directly with JSON-RPC:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","clientInfo":{"name":"test","version":"1.0"}}}' | ./chatgpt-handoff
echo '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' | ./chatgpt-handoff
echo '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"ask_chatgpt","arguments":{"prompt":"Research the latest AI trends in 2025, focusing on practical applications and market impact."}}}' | ./chatgpt-handoff

Troubleshooting

Linux Clipboard Issues

If clipboard copying fails, ensure you have xclip or xsel installed:

which xclip || which xsel

License

MIT License - see LICENSE file for details.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Future Enhancements

• Multiple clipboard formats (plain text, markdown, etc.)
• Optional prompt preprocessing/formatting
• Support for additional clipboard utilities