chatgpt-mcp

ChatGPT MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with the ChatGPT desktop app on macOS.

https://github.com/user-attachments/assets/a30c9b34-cdbe-4c0e-a0b0-33eb5054db5c

Language Support

Supported system languages for response detection:

• Korean
• English

If your macOS system language is not listed above, please follow these instructions:

1. Make sure ChatGPT desktop app is running
2. Run show_all_button_names.applescript and copy the output to create an issue for language support.

Features

• Send prompts to ChatGPT from any MCP-compatible AI assistant
• Built with Python and FastMCP

Note: This server only supports English text input. Non-English characters may not work properly.

Installation

Prerequisites

• macOS
• ChatGPT desktop app installed and running
• Python 3.10+
• uv package manager

For Claude Code Users

Simply run:

claude mcp add chatgpt-mcp uvx chatgpt-mcp

That's it! You can start using ChatGPT commands in Claude Code.

For Other MCP Clients

Step 1: Install the MCP Server

Option A: Install from PyPI (Recommended)

# Install with uv
uv add chatgpt-mcp

Option B: Manual Installation

# Clone the repository
git clone https://github.com/xncbf/chatgpt-mcp
cd chatgpt-mcp

# Install dependencies with uv
uv sync

Step 2: Configure Your MCP Client

If installed from PyPI, add to your MCP client configuration:

{
  "mcpServers": {
    "chatgpt": {
      "command": "uvx",
      "args": ["chatgpt-mcp"]
    }
  }
}

If manually installed, add to your MCP client configuration:

{
  "mcpServers": {
    "chatgpt": {
      "command": "uv",
      "args": ["run", "chatgpt-mcp"],
      "cwd": "/path/to/chatgpt-mcp"
    }
  }
}

Usage

1. Open ChatGPT desktop app and make sure it's running
2. Open your MCP client (Claude Code, etc.)
3. Use ChatGPT commands in your AI assistant:
   • "Send a message to ChatGPT"

The AI assistant will automatically use the appropriate MCP tools to interact with ChatGPT.

Available Tools

ask_chatgpt

Send a prompt to ChatGPT and receive the response.

ask_chatgpt(prompt="Hello, ChatGPT!")

get_chatgpt_response

Get the latest response from ChatGPT after sending a message.

get_chatgpt_response()

License

MIT