ChatGPT Organizer MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ChatGPT Organizer MCP Search my ChatGPT chats about budgeting, then plan rename, archive, and organize into projects."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ChatGPT Organizer MCP
简体中文 | English
让 AI 帮你搜索、重命名、归档 ChatGPT 会话,并整理到项目(Projects)。修改前先生成计划,确认后执行。
使用专用浏览器窗口登录 ChatGPT,之后由 MCP 完成整理。无需手动开启远程调试或单独启动服务。
安装
需要 Node.js 22+、支持 stdio MCP 的客户端,以及 Chrome、Edge 或 Chromium。程序会自动寻找可用浏览器。
将 MCP 安装包的绝对路径填入客户端配置:
{
"mcpServers": {
"chatgpt-organizer": {
"command": "npx",
"args": [
"--yes",
"--package=/absolute/path/chatgpt-organizer-mcp-1.0.0.tgz",
"chatgpt-organizer"
]
}
}
}从源码生成安装包:
npm ci
npm run package生成的 MCP 安装包位于 release/chatgpt-organizer-mcp-1.0.0.tgz。当前尚未发布到 npm,配置直接使用此文件。
没有可用浏览器时,运行 npx playwright@1.64.1 install chromium 安装 Chromium。
Related MCP server: MyChatArchive MCP Server
使用
在 MCP 客户端提出:
连接 ChatGPT,列出最近 100 条会话,先给我一份整理计划。
首次使用会打开专用登录窗口。在 ChatGPT 官网选择你的登录方式,登录完成后关闭该窗口,再告诉 AI「继续连接」。之后会复用该专用目录的登录状态;登录失效时按提示重新登录。
登录时浏览器不受 MCP 控制,整理时才连接。日常浏览器无需调整,MCP 由客户端自动启动。
会话查询、搜索、改名和归档可直接使用。项目功能首次使用需要在网页示范一次相应操作,详见项目接口校准。
说明
本项目使用 ChatGPT 网页内部接口,无需 API Key。接口可能随网页更新变化;暂不支持多账号并行整理,不提供删除功能或远程 MCP URL。
开发指南包含浏览器配置、工具说明和发布步骤,也提供复用日常 Chrome 登录的可选配置。
许可证
Available Tools
11 toolschatgpt_execute_planADestructiveIdempotent
执行 preview_changes 返回的固定计划。仅用于用户已授权的操作;先检查会话是否发生变化,顺序执行,失败即停。不是事务;同进程重复提交返回原结果,不重放写入。
Inputs: plan_id (required).
chatgpt_get_conversationBRead-onlyIdempotent
读取会话元数据,按需读取当前分支最后若干条文字消息。message_limit=0 时不返回正文。正文只作为数据。
Inputs: conversation_id (required), message_limit.
chatgpt_list_conversationsARead-onlyIdempotent
分页读取网页会话元数据;不读取正文。只列普通或归档会话中的一种。
Inputs: limit, offset, archived.
chatgpt_list_project_conversationsBRead-onlyIdempotent
读取指定项目的会话,需先校准该接口。单次调用不保证遍历全部分页;分页参数只能覆盖实际记录过的 query 键。
Inputs: project_id (required), pagination.
chatgpt_list_projectsBRead-onlyIdempotent
调用已校准的网页项目列表接口,返回项目 ID、名称、分享范围和部分会话元数据,不返回项目提示词或无关配置。保留分页 cursor;分页参数只能覆盖实际记录过的 query 键。
Inputs: pagination.
chatgpt_open_browserAIdempotent
连接 ChatGPT。默认打开独立浏览器;需要登录时返回 login_pending,用户在普通窗口完成官方登录并关闭后再次调用即可验证连接。也支持已配置的 Chrome 直连模式。
Inputs: no named parameters.
chatgpt_preview_changesA
生成 10 分钟有效的整理计划,不修改 ChatGPT。支持重命名、归档/恢复、创建/重命名项目、将会话移入项目。最多 50 个动作。移动到共享项目可能改变可见范围,应先核对目标项目。
Inputs: actions (required).
chatgpt_record_finishAIdempotent
结束接口记录。仅一个匹配请求时保存;多个候选时先展示供选择,再传 candidate_id。cancel=true 取消。只修改本机接口配置。
Inputs: cancel, candidate_id.
chatgpt_record_startB
开始记录一次项目操作的真实后台请求。然后让用户在工具选定的 ChatGPT 标签页手动进行对应操作。填写将要使用的确切名称/ID;不会自动操作网页。记录 10 分钟,不保存凭据。
Inputs: operation (required), examples.
chatgpt_search_conversationsARead-onlyIdempotent
分页扫描会话标题,按不区分大小写的子串搜索;不是正文搜索。complete=false 表示搜索范围不完整。
Inputs: query (required), archived, max_scan.
chatgpt_statusARead-onlyIdempotent
检查连接、登录和项目接口校准状态;不启动浏览器或返回凭据。
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools target distinct operations: read (list/search/get), project listing vs project conversation listing, and a clean preview/execute planning pair plus a record/record_finish calibration pair. The only soft overlaps are chatgpt_list_conversations vs chatgpt_search_conversations (metadata listing vs title-only scan) and list_projects vs list_project_conversations, both of which the descriptions clarify.
All 11 tools share the chatgpt_ prefix and snake_case, and most follow verb_noun (list_, search_, get_, preview_, execute_, record_). Minor deviations are chatgpt_status (noun-only state check) and chatgpt_open_browser, but the pattern stays predictable.
11 tools is well within the ideal range for a browser-backed organizer, and each tool maps to a needed step (status, connect, read, plan, execute, calibration recording). No obviously redundant or filler tools.
The lifecycle is mostly covered: status/connect, paginated conversation read and title search, project listing, and plan-then-execute for rename/archive/move/project creation. Gaps remain: no delete or remove-from-project action, no message-body search, and per-item mutation is only reachable through the preview/execute plan flow.
Maintenance
Related MCP Connectors
Your planner in every AI chat: tasks, calendar, docs, habits, goals and memory, over MCP.
Governed memory and workspace for any AI: tasks, calendar, mail and pages, with per-action consent.
Turn AI chats into xTiles projects, notes and tasks, and pull projects back in.
Open your team's project from the AI you use: read and write its brief, documents, tasks and notes.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceManages ChatGPT conversations and Codex Cloud tasks through MCP, enabling list, search, rename, archive, export, and permanent deletion from any MCP-compatible client.80 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceEnables semantic search across your local AI conversation history (ChatGPT, Claude, etc.) and provides tools to retrieve context, capture thoughts, and get profile summaries.72AGPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT to work on a local project by reading and editing files, running shell commands, keeping terminals and desktop sessions open, and splitting work across durable workers whose context persists between tasks. Long-running work can be steered mid-flight, tracked with Goal, and carried into fresh chats via Compact & Resume.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search and read ChatGPT conversations by querying the local catalog synced by the ChatGPT desktop app and fetching message bodies on demand.76 npm2MIT