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:
- Make sure ChatGPT desktop app is running
- Run
show_all_button_names.applescriptand 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
- Open ChatGPT desktop app and make sure it's running
- Open your MCP client (Claude Code, etc.)
- 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:
-
Install in editable mode
uv pip install -e .
-
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
Metadata
Release files for iflow-mcp_chatgpt-mcp 1.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_chatgpt_mcp-1.2.1.tar.gz | 8.7 kB | Without provenance | Details for iflow_mcp_chatgpt_mcp-1.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_chatgpt_mcp-1.2.1-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_chatgpt_mcp-1.2.1-py3-none-any.whl |
Total release size: 19.0 kB
Release files / iflow_mcp_chatgpt_mcp-1.2.1.tar.gz
| Download URL | iflow_mcp_chatgpt_mcp-1.2.1.tar.gz |
|---|---|
| Size | 8.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e019dfe35aa2b2dc9fee3ffd80c8faf1f6fe2eb937b4e5d26c6134b553c01a91
|
|
BLAKE2b-256 checksum How to use checksums |
fedc5fb7cb3b505f1d100052b9f86662702f6b9af040009c7dff8386d66049b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.17
|
Release files / iflow_mcp_chatgpt_mcp-1.2.1-py3-none-any.whl
| Download URL | iflow_mcp_chatgpt_mcp-1.2.1-py3-none-any.whl |
|---|---|
| Size | 10.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ac0e23451c709b0c5da2cf29e84d14e79e50659a82af4ee5cb9b855daa50f0fe
|
|
BLAKE2b-256 checksum How to use checksums |
4a964bc2c29c7eab20abdda1fd1b80a0ff852615d4c40cb6d0f3cd068ce99792
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.17
|
Security for iflow-mcp_chatgpt-mcp 1.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.