Skip to main content

A Model Context Protocol server for interacting with ChatGPT on macOS with Korean support

Project description

ChatGPT MCP Server

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

ChatGPT Server MCP server

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()

new_chatgpt_chat

Start a new chat conversation in ChatGPT.

new_chatgpt_chat()

Development

Local Testing

To test the MCP server locally during development:

  1. Install in editable mode

    uv pip install -e .
    
  2. Test with MCP Inspector

    npx @modelcontextprotocol/inspector chatgpt-mcp
    

The editable installation creates a chatgpt-mcp command that directly references your source code, so any changes you make are immediately reflected without reinstalling.

Running without installation

You can also run the server directly:

PYTHONPATH=. uv run python -m chatgpt_mcp.chatgpt_mcp

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_xncbf_chatgpt_mcp-1.2.1.tar.gz (9.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_xncbf_chatgpt_mcp-1.2.1-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_xncbf_chatgpt_mcp-1.2.1.tar.gz.

File metadata

  • Download URL: iflow_mcp_xncbf_chatgpt_mcp-1.2.1.tar.gz
  • Upload date:
  • Size: 9.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_xncbf_chatgpt_mcp-1.2.1.tar.gz
Algorithm Hash digest
SHA256 bb0fe180bb067378c4dc12e9a8c3921ab69dbf60d1115f2bd7d01ca979d08563
MD5 20614dc743208b0286e83222c039c570
BLAKE2b-256 76e39d0d25a3e271ff9d312a9081a5b8975be5b517e502eb4081351e81c1ccab

See more details on using hashes here.

File details

Details for the file iflow_mcp_xncbf_chatgpt_mcp-1.2.1-py3-none-any.whl.

File metadata

  • Download URL: iflow_mcp_xncbf_chatgpt_mcp-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 10.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for iflow_mcp_xncbf_chatgpt_mcp-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 55876e688c84e71f9b70c1c0099de8adbb862a232009f135b246e8d2aeeed1d3
MD5 667690ce46e55f1e4aba3ee154df0a4a
BLAKE2b-256 34867c487928b6b206cf0471bb18116e007f18d1dcabd8fb2eb3170ca1203928

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page