Windows ChatGPT MCP

Windows ChatGPT MCP Tool

⚠️ NOTICE: PRE-TESTING VERSION ⚠️
This tool is currently in development and has NOT been fully tested. Use at your own risk.
Comprehensive testing and validation are planned before the first stable release.

A Model Context Protocol (MCP) server that enables Claude Desktop and VS Code Claude CLI to interact with ChatGPT on Windows 11 systems.

Overview

This tool provides a bridge between Claude and ChatGPT on Windows, allowing you to leverage ChatGPT functionality within your Claude workflow through the MCP protocol. Get the best of both AI systems by combining Claude's analytical capabilities with ChatGPT's knowledge and conversational abilities.

Note: This is a Windows adaptation of the original claude-chatgpt-mcp tool for macOS, redesigned with Windows-native automation and enhanced features.

Key Features

🔗 Seamless Integration - Connect Claude with ChatGPT through MCP protocol
🪟 Windows Native - Optimized for Windows 11/10 with robust automation
🛠️ Multiple Tools - Send messages, manage conversations, get debug info
📊 Performance Monitoring - Built-in metrics and logging
🔧 Easy Configuration - Works with Claude Desktop and VS Code
🛡️ Error Handling - Comprehensive error recovery and retry logic

Quick Start

Prerequisites

✅ Windows 11 (or Windows 10 1903+)
✅ Python 3.8 or higher
✅ ChatGPT desktop application
✅ Claude Desktop OR VS Code with Claude CLI extension

Installation

Option 1: Pip Installation (Recommended)

pip install windows-chatgpt-mcp

Option 2: Standalone Executable

Download windows-chatgpt-mcp.exe from the releases page
Place the executable in your desired directory
Run directly without Python installation required

Option 3: Development Installation

Clone the repository:
git clone https://github.com/kyungsuk-kim/windows-chatgpt-mcp.git cd windows-chatgpt-mcp
Install dependencies:
pip install -r requirements.txt
Install the package:
pip install -e .
Verify installation:
python -m src.mcp_server --test

Configuration

For Claude Desktop

Create or edit %APPDATA%\Claude\mcp.json:

{
  "mcpServers": {
    "windows-chatgpt": {
      "command": "python",
      "args": ["-m", "src.mcp_server"],
      "cwd": "C:/path/to/windows-chatgpt-mcp",
      "env": {
        "PYTHONPATH": "C:/path/to/windows-chatgpt-mcp/src",
        "WINDOWS_CHATGPT_MCP_LOG_LEVEL": "INFO"
      }
    }
  }
}

For VS Code Claude CLI

Add to your VS Code settings:

{
  "claude.mcpServers": {
    "windows-chatgpt": {
      "command": "python",
      "args": ["-m", "src.mcp_server"],
      "cwd": "C:/path/to/windows-chatgpt-mcp",
      "env": {
        "PYTHONPATH": "C:/path/to/windows-chatgpt-mcp/src"
      }
    }
  }
}

Usage

Basic Usage

Once configured, you can use ChatGPT through Claude:

You: Can you use the ChatGPT tool to ask: "What are the benefits of renewable energy?"

Claude: I'll send that question to ChatGPT for you.

[Uses send_message tool]

ChatGPT Response: Renewable energy offers numerous benefits including...

Claude: Based on ChatGPT's response, I can also add that...

Available Tools

Tool	Description	Usage
`send_message`	Send a message to ChatGPT	Ask Claude to send any question or request
`get_conversation_history`	Get recent ChatGPT messages	"Show me the last 5 ChatGPT messages"
`reset_conversation`	Start fresh in ChatGPT	"Reset the ChatGPT conversation"
`get_debug_info`	Server diagnostics	"Get debug info from the ChatGPT tool"

Common Use Cases

Research & Analysis - Get multiple AI perspectives on complex topics
Code Review - Have both AIs review your code for comprehensive feedback
Creative Writing - Collaborate between AIs for enhanced creativity
Problem Solving - Combine analytical approaches from both systems
Learning - Use both AIs for comprehensive educational content

Documentation

📖 User Guide - Comprehensive usage instructions
🔧 Setup Guide - Detailed installation and configuration
📚 API Reference - Technical API documentation
❓ FAQ - Frequently asked questions
🎯 Usage Scenarios - Real-world examples
🔍 Troubleshooting - Common issues and solutions

Configuration Examples

Development Setup

{
  "mcpServers": {
    "chatgpt-dev": {
      "command": "python",
      "args": ["-m", "src.mcp_server", "--debug"],
      "cwd": "C:/dev/windows-chatgpt-mcp",
      "env": {
        "WINDOWS_CHATGPT_MCP_LOG_LEVEL": "DEBUG",
        "WINDOWS_CHATGPT_MCP_TIMEOUT": "60"
      }
    }
  }
}

Production Setup

{
  "mcpServers": {
    "windows-chatgpt": {
      "command": "windows-chatgpt-mcp",
      "args": [],
      "env": {
        "WINDOWS_CHATGPT_MCP_LOG_LEVEL": "WARNING",
        "WINDOWS_CHATGPT_MCP_TIMEOUT": "30"
      }
    }
  }
}

Environment Variables

Variable	Default	Description
`WINDOWS_CHATGPT_MCP_LOG_LEVEL`	`INFO`	Logging verbosity
`WINDOWS_CHATGPT_MCP_TIMEOUT`	`30`	Response timeout (seconds)
`WINDOWS_CHATGPT_MCP_DEBUG`	`false`	Enable debug mode
`WINDOWS_CHATGPT_MCP_WINDOW_TITLE`	`ChatGPT`	Window detection pattern

Troubleshooting

Common Issues

ChatGPT not found:

Ensure ChatGPT desktop app is running and visible
Check window title matches expected pattern

Permission denied:

Run as administrator
Check Windows privacy settings for app control

Timeout errors:

Increase timeout value in configuration
Ensure stable internet connection

For detailed troubleshooting, see TROUBLESHOOTING.md

Performance

The tool includes comprehensive performance monitoring:

Response time tracking
Success/failure rates
Error categorization
Resource usage monitoring

Access performance data using the get_debug_info tool.

Security

Messages are processed locally through ChatGPT desktop app
No data is stored permanently by the MCP server
Follows Windows security best practices
Configurable logging levels to protect sensitive information

Contributing

We welcome contributions! Please read our Contributing Guidelines for detailed information.

Quick Start for Contributors

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and add tests
Run the test suite: python run_tests.py
Submit a pull request

Development Setup

# Clone your fork
git clone https://github.com/yourusername/windows-chatgpt-mcp.git
cd windows-chatgpt-mcp

# Create virtual environment
python -m venv venv
venv\Scripts\activate

# Install development dependencies
pip install -e .[dev]

# Install pre-commit hooks
pre-commit install

For detailed contributing guidelines, see CONTRIBUTING.md.

Support

Getting Help

📖 Documentation - Comprehensive guides in the docs/ directory
🐛 Bug Reports - Report issues on GitHub Issues
💬 Discussions - Ask questions in GitHub Discussions
🔍 Troubleshooting - Check TROUBLESHOOTING.md for common issues

Community

GitHub Repository: windows-chatgpt-mcp
Issue Tracker: Report bugs and request features
Discussions: Community discussions and Q&A

Professional Support

For enterprise support, custom integrations, or consulting services, please contact the maintainers through GitHub.

Distribution

Available Packages

The Windows ChatGPT MCP Tool is distributed in multiple formats:

Wheel Package: windows_chatgpt_mcp-1.0.0-py3-none-any.whl - Standard Python package
Source Distribution: windows_chatgpt_mcp-1.0.0.tar.gz - Source code archive
Standalone Executable: windows-chatgpt-mcp.exe - No Python installation required

Building from Source

To build your own distribution packages:

# Build all packages
python build_dist.py

# Build only wheel package
python build_dist.py --wheel-only

# Build only standalone executable
python build_dist.py --exe-only

For detailed build instructions, see DISTRIBUTION.md.

Roadmap

Version 1.1 (Planned)

Image and file attachment support
Enhanced error recovery mechanisms
Performance optimizations

Version 1.2 (Future)

Multiple ChatGPT account support
Enhanced conversation management
Additional automation features
Configuration GUI

Long-term Goals

Cross-platform support (macOS, Linux)
Plugin system for extensibility
Advanced AI workflow automation

License

MIT License - see LICENSE file for details.

Acknowledgments

This Windows ChatGPT MCP tool is based on the excellent work by syedazharmbnr1 and their claude-chatgpt-mcp project for macOS. We adapted their innovative approach to create a Windows-native version with enhanced automation capabilities.

Credits

Original Project: claude-chatgpt-mcp by syedazharmbnr1
Platform: Adapted from macOS to Windows with Windows-specific automation
MCP Protocol: Built on the Model Context Protocol (MCP) standard
Windows Integration: Uses Windows automation libraries for ChatGPT desktop app integration

Key Adaptations for Windows

Windows-native automation using pyautogui and pygetwindow
Windows-specific window management and detection
Enhanced error handling for Windows environment
Windows registry and file system integration
Comprehensive Windows installation and deployment support

Ready to get started? Follow the Setup Guide for detailed installation instructions.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

local-only server

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

Enables Claude Desktop and VS Code Claude CLI to interact with ChatGPT on Windows systems through the MCP protocol. Provides seamless integration allowing users to leverage ChatGPT functionality within their Claude workflow with tools for sending messages, managing conversations, and accessing ChatGPT responses.

Related MCP Servers

ClaudeKeep
sdairs
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 -
2
11
TypeScript
MIT License
MCP Tool
PiuQiuPiaQia
A
security
F
license
A
quality
A server built on mcp-framework that enables integration with Claude Desktop through the Model Context Protocol.
Last updated -
1
1
MCP ChatGPT Responses
billster45
-
security
F
license
-
quality
MCP ChatGPT Responses connects Claude to ChatGPT through two essential tools: standard queries for AI-to-AI conversations and web-enabled requests for current information. It uses OpenAI's Responses API to maintain conversation state automatically.
Last updated -
13
Python
Claude MCP Server Integration
mokemoke0821
-
security
F
license
-
quality
Integration project for Model Context Protocol (MCP) servers with Claude Desktop App, enabling filesystem operations, development support, and file management through natural language.
Last updated -
TypeScript

View all related MCP servers