{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_bgtby9jzq3dt","handle":"codex-chats-mcp","url":"https://wellknown.network/agents/codex-chats-mcp","links":{"self":"https://wellknown.network/agents/codex-chats-mcp/record.json","html":"https://wellknown.network/agents/codex-chats-mcp","markdown":"https://wellknown.network/agents/codex-chats-mcp/record.md","api":"https://wellknown.network/api/v1/agents/codex-chats-mcp","status":"https://wellknown.network/api/v1/agents/codex-chats-mcp/status","claim":"https://wellknown.network/agents/codex-chats-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/codex-chats-mcp/claim.json","badge":"https://wellknown.network/agents/codex-chats-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:codex-chats-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"codex-chats-mcp","summary":"MCP server to list, search, archive, rename, export, and delete ChatGPT conversations and Codex Cloud tasks.","description":"# codex-chats-mcp\n\nAn MCP server for managing ChatGPT conversations and Codex Cloud tasks (chats) from any MCP-compatible client — Claude Code, Codex, Cline, etc.\n\nChatGPT'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.\n\n> **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.\n\n## Install\n\n```bash\npip install git+https://github.com/shoyu-ramen/codex-chats-mcp\n```\n\nOr with `uv`:\n\n```bash\nuv tool install git+https://github.com/shoyu-ramen/codex-chats-mcp\n```\n\nThis installs a `codex-chats-mcp` executable.\n\n## Authentication\n\nThe 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.\n\nThe token has full access to your ChatGPT account. Treat the auth file as a secret.\n\n## Wire it up\n\n### Codex CLI (`~/.codex/config.toml`)\n\n```toml\n[mcp_servers.codex-chats]\ncommand = \"codex-chats-mcp\"\n```\n\n### Claude Code\n\n```bash\nclaude mcp add codex-chats codex-chats-mcp\n```\n\n### Anything else\n\nPoint your MCP client at the `codex-chats-mcp` executable. It speaks MCP over stdio.\n\n## Tools\n\n### ChatGPT conversations (the \"Recents\" list)\n\n| Tool | What it does |\n|---|---|\n| `list_conversations` | Paginates through your conversations. Filters out archived by default. |\n| `get_conversation` | Full payload for one conversation, including the message tree. |\n| `search_conversations` | Substring match on titles (client-side). |\n| `rename_conversation` | Change a conversation's title. |\n| `archive_conversation` / `unarchive_conver…","publisher":{"name":"Ross Kuehl","url":null},"homepage":"https://github.com/shoyu-ramen/codex-chats-mcp","repository":"https://github.com/shoyu-ramen/codex-chats-mcp","version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","chatgpt","codex","claude"],"pricing":null,"endpoints":[{"url":"pypi:codex-chats-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"communication.chat","name":"Team Chat","confidence":1,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["communication","dev","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"codex-chats-mcp","registry":"pypi","observedAt":"2026-09-09T12:29:32.261Z","publishedAt":"2026-05-21T17:33:18.376559Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"codex-chats-mcp","url":"https://pypi.org/project/codex-chats-mcp/","firstSeenAt":"2026-09-09T12:27:06.590Z","fetchedAt":"2026-09-09T13:19:54.181Z","normalizedAt":"2026-09-09T13:19:54.181Z"}]},"firstSeenAt":"2026-09-09T12:27:06.590Z","updatedAt":"2026-09-09T12:29:32.261Z"}