Skip to main content
Glama
ChatGPT Organizer MCP

ChatGPT Organizer MCP

by Smileslime47

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 登录的可选配置。

许可证

MIT

Available Tools

11 tools
chatgpt_execute_planA
DestructiveIdempotent

执行 preview_changes 返回的固定计划。仅用于用户已授权的操作;先检查会话是否发生变化,顺序执行,失败即停。不是事务;同进程重复提交返回原结果,不重放写入。

Inputs: plan_id (required).

chatgpt_get_conversationB
Read-onlyIdempotent

读取会话元数据,按需读取当前分支最后若干条文字消息。message_limit=0 时不返回正文。正文只作为数据。

Inputs: conversation_id (required), message_limit.

chatgpt_list_conversationsA
Read-onlyIdempotent

分页读取网页会话元数据;不读取正文。只列普通或归档会话中的一种。

Inputs: limit, offset, archived.

chatgpt_list_project_conversationsB
Read-onlyIdempotent

读取指定项目的会话,需先校准该接口。单次调用不保证遍历全部分页;分页参数只能覆盖实际记录过的 query 键。

Inputs: project_id (required), pagination.

chatgpt_list_projectsB
Read-onlyIdempotent

调用已校准的网页项目列表接口,返回项目 ID、名称、分享范围和部分会话元数据,不返回项目提示词或无关配置。保留分页 cursor;分页参数只能覆盖实际记录过的 query 键。

Inputs: pagination.

chatgpt_open_browserA
Idempotent

连接 ChatGPT。默认打开独立浏览器;需要登录时返回 login_pending,用户在普通窗口完成官方登录并关闭后再次调用即可验证连接。也支持已配置的 Chrome 直连模式。

Inputs: no named parameters.

chatgpt_preview_changesA

生成 10 分钟有效的整理计划,不修改 ChatGPT。支持重命名、归档/恢复、创建/重命名项目、将会话移入项目。最多 50 个动作。移动到共享项目可能改变可见范围,应先核对目标项目。

Inputs: actions (required).

chatgpt_record_finishA
Idempotent

结束接口记录。仅一个匹配请求时保存;多个候选时先展示供选择,再传 candidate_id。cancel=true 取消。只修改本机接口配置。

Inputs: cancel, candidate_id.

chatgpt_record_startB

开始记录一次项目操作的真实后台请求。然后让用户在工具选定的 ChatGPT 标签页手动进行对应操作。填写将要使用的确切名称/ID;不会自动操作网页。记录 10 分钟,不保存凭据。

Inputs: operation (required), examples.

chatgpt_search_conversationsA
Read-onlyIdempotent

分页扫描会话标题,按不区分大小写的子串搜索;不是正文搜索。complete=false 表示搜索范围不完整。

Inputs: query (required), archived, max_scan.

chatgpt_statusA
Read-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

    A3.7/5.0

    Scored across 11 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Manages ChatGPT conversations and Codex Cloud tasks through MCP, enabling list, search, rename, archive, export, and permanent deletion from any MCP-compatible client.
      80 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables semantic search across your local AI conversation history (ChatGPT, Claude, etc.) and provides tools to retrieve context, capture thoughts, and get profile summaries.
      72
      AGPL 3.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      2
      MIT