MCP server to list, search, archive, rename, export, and delete ChatGPT conversations and Codex Cloud tasks.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"codex-chats-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# codex-chats-mcp An MCP server for managing ChatGPT conversations and Codex Cloud tasks (chats) from any MCP-compatible client — Claude Code, Codex, Cline, etc. ChatGPT's web UI lets you archive chats but the "Delete all" button only wipes visible ones, and Codex Cloud has no per-task delete at all. This server wraps the internal `chatgpt.com/backend-api` endpoints so you can list, search, rename, archive, export, and **permanently delete** both kinds of chats from your agent. > **Unofficial.** This uses undocumented internal endpoints (`/conversations/*`, `/wham/tasks/*`). They can change without notice and require a valid ChatGPT session. Use at your own risk. ## Install ```bash pip install git+https://github.com/shoyu-ramen/codex-chats-mcp ``` Or with `uv`: ```bash uv tool install git+https://github.com/shoyu-ramen/codex-chats-mcp ``` This installs a `codex-chats-mcp` executable. ## Authentication The server reads `~/.codex/auth.json` — the same file the Codex CLI maintains after `codex login`. If you don't have Codex installed, log in once with `npx @openai/codex login` (or sign in via the Codex desktop app) to produce the file. The token has full access to your ChatGPT account. Treat the auth file as a secret. ## Wire it up ### Codex CLI (`~/.codex/config.toml`) ```toml [mcp_servers.codex-chats] command = "codex-chats-mcp" ``` ### Claude Code ```bash claude mcp add codex-chats codex-chats-mcp ``` ### Anything else Point your MCP client at the `codex-chats-mcp` executable. It speaks MCP over stdio. ## Tools ### ChatGPT conversations (the "Recents" list) | Tool | What it does | |---|---| | `list_conversations` | Paginates through your conversations. Filters out archived by default. | | `get_conversation` | Full payload for one conversation, including the message tree. | | `search_conversations` | Substring match on titles (client-side). | | `rename_conversation` | Change a conversation's title. | | `archive_conversation` / `unarchive_conver…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.