chatgpt-mcp

MCP server for reading shared ChatGPT conversations into Goose.

Paste a ChatGPT share link, get the full conversation transcript. Built for the workflow: ideate in ChatGPT, synthesize in Goose.

Install

cd ~/development/chatgpt-mcp
uv pip install -e .

Related MCP server: Webustler

Goose Config

Add to ~/.config/goose/config.yaml:

chatgpt:
  enabled: true
  type: stdio
  name: ChatGPT Reader
  description: Read shared ChatGPT conversations
  cmd: uv
  args:
    - run
    - --directory
    - /path/to/chatgpt-mcp
    - chatgpt-mcp
  envs: {}
  env_keys: []
  timeout: 30
  bundled: false
  available_tools: []

Tools

fetch_chatgpt_conversation(url)

Returns the conversation as a markdown transcript with role labels.

fetch_chatgpt_conversation_json(url)

Returns structured JSON with title, messages array, model info.

How It Works

1. Takes a ChatGPT share URL (https://chatgpt.com/share/...)

2. Fetches the HTML page (no auth needed for shared links)

3. Extracts conversation data from the React Router streaming payload or __NEXT_DATA__

4. Parses the message tree (handles branching conversations by walking the mapping)

5. Returns formatted transcript

Limitations

• Only works with publicly shared conversations (via ChatGPT's Share button)

• Private/unshared conversations require auth and are not supported

• If OpenAI changes their share page HTML structure, the parser may need updating