MCP ChatGPT Server

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/billster45-mcp-chatgpt-responses-badge.png)](https://mseep.ai/app/billster45-mcp-chatgpt-responses)
2 
3# MCP ChatGPT Server
4[![smithery badge](https://smithery.ai/badge/@billster45/mcp-chatgpt-responses)](https://smithery.ai/server/@billster45/mcp-chatgpt-responses)
5 
6This MCP server allows you to access OpenAI's ChatGPT API directly from Claude Desktop.
7 
8📝 **Read about why I built this project**: [I Built an AI That Talks to Other AIs: Demystifying the MCP Hype](https://medium.com/@billcockerill/i-built-an-ai-that-talks-to-other-ais-demystifying-the-mcp-hype-88dc03520552)
9 
10## Features
11 
12- Call the ChatGPT API with customisable parameters
13- Aks Claude and ChatGPT to talk to each other in a long running discussion!
14- Configure model versions, temperature, and other parameters
15- Use web search to get up-to-date information from the internet
16- Uses OpenAI's Responses API for automatic conversation state management
17- Use your own OpenAI API key
18 
19## Setup Instructions
20 
21### Installing via Smithery
22 
23To install ChatGPT Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@billster45/mcp-chatgpt-responses):
24 
25```bash
26npx -y @smithery/cli install @billster45/mcp-chatgpt-responses --client claude
27```
28 
29### Prerequisites
30 
31- Python 3.10 or higher
32- [Claude Desktop](https://claude.ai/download) application
33- [OpenAI API key](https://platform.openai.com/settings/organization/api-keys)
34- [uv](https://github.com/astral-sh/uv) for Python package management
35 
36### Installation
37 
381. Clone this repository:
39   ```bash
40   git clone https://github.com/billster45/mcp-chatgpt-responses.git
41   cd mcp-chatgpt-responses
42   ```
43 
442. Set up a virtual environment and install dependencies using uv:
45   ```bash
46   uv venv
47   ```
48 
49   ```bash
50   .venv\\Scripts\\activate
51   ```
52   
53   ```bash
54   uv pip install -r requirements.txt
55   ```
56 
57### Using with Claude Desktop
58 
591. Configure Claude Desktop to use this MCP server by following the instructions at:
60   [MCP Quickstart Guide](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server)
61 
622. Add the following configuration to your Claude Desktop config file (adjust paths as needed):
63   ```json
64   {
65     "mcpServers": {
66       "chatgpt": {
67         "command": "uv",
68         "args": [
69           "--directory",
70           "\\path\\to\\mcp-chatgpt-responses",
71           "run",
72           "chatgpt_server.py"
73         ],
74         "env": {
75           "OPENAI_API_KEY": "your-api-key-here",
76           "DEFAULT_MODEL": "gpt-4o",
77           "DEFAULT_TEMPERATURE": "0.7",
78           "MAX_TOKENS": "1000"
79         }
80       }
81     }
82   }
83   ```
84 
853. Restart Claude Desktop.
86 
874. You can now use the ChatGPT API through Claude by asking questions that mention ChatGPT or that Claude might not be able to answer.
88 
89## Available Tools
90 
91The MCP server provides the following tools:
92 
931. `ask_chatgpt(prompt, model, temperature, max_output_tokens, response_id)` - Send a prompt to ChatGPT and get a response
94 
952. `ask_chatgpt_with_web_search(prompt, model, temperature, max_output_tokens, response_id)` - Send a prompt to ChatGPT with web search enabled to get up-to-date information
96 
97## Example Usage
98 
99### Basic ChatGPT usage:
100 
101Tell Claude to ask ChatGPT a question!
102```
103Use the ask_chatgpt tool to answer: What is the best way to learn Python?
104```
105 
106Tell Claude to have a conversation with ChatGPT:
107```
108Use the ask_chatgpt tool to have a two way conversation between you and ChatGPT about the topic that is most important to you.
109```
110Note how in a turn taking conversation the response id allows ChatGPT to store the history of the conversation so its a genuine conversation and not just as series of API calls. This is called [conversation state](https://platform.openai.com/docs/guides/conversation-state?api-mode=responses#openai-apis-for-conversation-state).
111 
112### With web search:
113 
114For questions that may benefit from up-to-date information:
115```
116Use the ask_chatgpt_with_web_search tool to answer: What are the latest developments in quantum computing?
117```
118 
119Now try web search in agentic way to plan your perfect day out based on the weather!
120```
121Use the ask_chatgpt_with_web_search tool to find the weather tomorrow in New York, then based on that weather and what it returns, keep using the tool to build up a great day out for someone who loves food and parks
122```
123 
124## How It Works
125 
126This tool utilizes OpenAI's Responses API, which automatically maintains conversation state on OpenAI's servers. This approach:
127 
1281. Simplifies code by letting OpenAI handle the conversation history
1292. Provides more reliable context tracking
1303. Improves the user experience by maintaining context across messages
1314. Allows access to the latest information from the web with the web search tool
132 
133## License
134 
135MIT License
136