ChatGPT Responses

MCP ChatGPT Server

[![smithery badge](https://smithery.ai/badge/@billster45/mcp-chatgpt-responses)](https://smithery.ai/server/@billster45/mcp-chatgpt-responses)

This MCP server allows you to access OpenAI's ChatGPT API directly from Claude Desktop.

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

Features

Call the ChatGPT API with customisable parameters

Aks Claude and ChatGPT to talk to each other in a long running discussion!

Configure model versions, temperature, and other parameters

Use web search to get up-to-date information from the internet

Uses OpenAI's Responses API for automatic conversation state management

Use your own OpenAI API key

Setup Instructions

Installing via Smithery

To install ChatGPT Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@billster45/mcp-chatgpt-responses):

Prerequisites

Python 3.10 or higher

[Claude Desktop](https://claude.ai/download) application

[OpenAI API key](https://platform.openai.com/settings/organization/api-keys)

[uv](https://github.com/astral-sh/uv) for Python package management

Installation

Clone this repository: ```bash git clone https://github.com/billster45/mcp-chatgpt-responses.git cd mcp-chatgpt-responses ```

Set up a virtual environment and install dependencies using uv: ```bash uv venv ``` ```bash .venv\\Scripts\\activate ``` ```bash uv pip install -r requirements.txt ```

Using with Claude Desktop

Configure Claude Desktop to use this MCP server by following the instructions at: [MCP Quickstart Guide](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server)

Add the following configuration to your Claude Desktop config file (adjust paths as needed): ```json { "mcpServers": { "chatgpt": { "command": "uv", "args": [ "--directory", "\\path\\to\\mcp-chatgpt-responses", "run", "chatgpt_server.py" ], "env": { "OPENAI_API_KEY": "your-api-key-here", "DEFAULT_MODEL": "gpt-4o", "DEFAULT_TEMPERATURE": "0.7", "MAX_TOKENS": "1000" } } } } ```

Restart Claude Desktop.

You can now use the ChatGPT API through Claude by asking questions that mention ChatGPT or that Claude might not be able to answer.

Available Tools

The MCP server provides the following tools:

`ask_chatgpt(prompt, model, temperature, max_output_tokens, response_id)` - Send a prompt to ChatGPT and get a response

`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

Example Usage

Basic ChatGPT usage:

Tell Claude to ask ChatGPT a question!

Tell Claude to have a conversation with ChatGPT:

Note 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).

With web search:

For questions that may benefit from up-to-date information:

Now try web search in agentic way to plan your perfect day out based on the weather!

How It Works

This tool utilizes OpenAI's Responses API, which automatically maintains conversation state on OpenAI's servers. This approach:

Simplifies code by letting OpenAI handle the conversation history

Provides more reliable context tracking

Improves the user experience by maintaining context across messages

Allows access to the latest information from the web with the web search tool

License

MIT License