1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | notion-openai-plugins |
| 项目自述名称 | Notion（.codex-plugin/plugin.json 内 interface.displayName 原值） |
| 作者/维护者 | OpenAI 官方编写并托管于官方仓库 openai/plugins；底层工具层依赖 Notion 官方运维的远程 MCP 服务器（mcp.notion.com） |
| 来源链接 | https://github.com/openai/plugins/tree/main/plugins/notion |
| 许可证 | MIT（plugin.json 明确声明） |
| GitHub Stars/Forks | 所属合集仓库 openai/plugins 4,584 / 664（GitHub API 实测 2026-07-15；该仓库是 170+ 插件的合集，星数不直接归属本插件，独立佐证见第 2、6 章） |
| 最新版本 | plugin.json 声明 0.1.5；子目录提交历史 API 实测：2026-03-16（首次导入）至 2026-06-23 共 18 次提交，最近一次距运行当天约 3 周 |
| 安装方式 | Codex CLI/App 内 Connected Apps 启用 Notion 连接，或直接引用插件目录 URL 安装；技能实际调用的工具由 Notion 官方远程 MCP 服务器（mcp.notion.com）提供 |
2. 功能介绍与亮点
插件捆绑 4 个独立 SKILL.md 技能，覆盖知识工作者最常见的四类重复劳动：
- notion-spec-to-implementation：把 Notion 里的 PRD/需求文档转成实施计划页 + 任务清单，并让 spec↔plan↔task 三者互链、进度随迭代同步
- notion-research-documentation：跨 Notion 工作区内容做研究，产出结构化简报或报告
- notion-meeting-intelligence：结合工作区上下文准备会议材料（议程、预读）
- notion-knowledge-capture：把对话、决策、临时笔记沉淀为可长期检索的 Notion 页面
亮点：4 个技能均配有 reference/（如 spec-parsing、task-creation、progress-tracking 等模板）与 examples/（端到端案例）完整文档，不是简单的 API 封装；更关键的是，其工具层通过 Notion 官方维护的远程 MCP 服务器提供，而非仅绑定 OpenAI 私有 Connector——同一套 Notion 官方工具命名空间理论上也能在其他 MCP 客户端中复用。
3. 适用场景
固定分类：集成与工作流自动化。适合已经把 Notion 当团队知识库/项目协作面板、又想用 Agent 减少“整理会议纪要、把需求拆成任务、翻研究资料写简报”这类重复劳动的初中级用户；尤其适合需要把开发计划、任务拆解与 Notion 现有 wiki 打通、不想在两套工具间手动复制粘贴的场景。
4. 跨 Agent 兼容性
- Codex：✅ 原生支持——
.codex-plugin/plugin.json为标准 Codex 插件清单，OpenAI 官方仓库直接维护 - Claude Code：✅ 可用（需自行接入）——插件通过
.mcp.json声明的 Notion 远程 MCP 服务器（mcp.notion.com）提供底层工具；Notion 官方文档（developers.notion.com）明确将 Claude Code 列为受支持客户端之一，已独立核实。但 4 份 SKILL.md 的具体工作流文案是为 Codex 场景撰写，迁移到 Claude Code 需自行接入同一 MCP 服务器并参照工作流手动复现，非一键安装 - OpenClaw：❓ 未验证——抓取材料未提及
- Hermes Agent：❓ 未验证——抓取材料未提及
（未为兼容性单独发起搜索，以上判断仅基于本次已抓取材料。）
5. 推荐理由
Notion 是全球最主流的团队知识库/协作工具之一，这个插件是 OpenAI 官方为 Codex 写的一整套“让 Agent 帮你维护 Notion”工作流，四个技能覆盖知识工作者最容易觉得繁琐的环节：把需求写成任务、把研究整理成简报、把会议记录变成纪要、把讨论沉淀成知识页，且每个技能都配了参考文档和示例。更关键的是，它依赖的不是 OpenAI 私有连接器，而是 Notion 自己运维的官方远程 MCP 服务器——这意味着背后这套工具能力并不锁死在 Codex 里，比大多数纯 Codex Connector 插件的兼容性更宽。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8.0 | OpenAI 官方出品，2026-03-27 随 Codex 插件市场上线，获 the-decoder.com 等多家独立科技媒体报道并点名 Notion（与 Slack、Figma 并列为旗舰示例）；Notion 官方也在自身 MCP 文档中确认该接入路径，双方独立信源交叉验证；未采用合集仓库整体 4,584 星归属本插件 |
| 可用性 | 9.0 | 4 个技能均配 reference/examples 完整文档；Connected Apps 一条开关即可启用；子目录近 3 周内仍有提交；仅需已有 Notion 账号，无付费依赖 |
| 安全性 | 7.0 | 见下方安全检查清单 |
| 综合 | 8.0 | 三项均值，超过 7.0 达标线，安全性远超一票否决线 |
安全检查清单：
- Shell 命令：无——纯提示词驱动的 MCP 工具调用工作流，未发现任何 shell 脚本
- 联网外发：仅通过 Notion 官方远程 MCP 服务器与用户自己的 Notion 工作区通信，目标透明且为完成功能所必需
- API Key/凭据：无裸 API Key，走 Codex 平台 OAuth Connector（
.app.json）+ Notion 官方 MCP OAuth 授权（.mcp.json声明oauth_resource） - 可疑指令：完整抓取 4 份 SKILL.md 全文（以 notion-spec-to-implementation 为例核实），未发现要求执行流程外操作的可疑指令；但需提醒：Notion MCP 生态存在已披露的“第三方页面内容提示词注入”风险（
makenotion/notion-mcp-serverissue #238），Notion 官方已发布 Agent 连接安全指南与缓解措施——这是该类工具的已知风险类别，非本插件自身代码缺陷，已计入本项扣分 - 作者/组织信誉：OpenAI（官方仓库）+ Notion（官方 MCP 服务提供方），均为一线机构
- License：MIT，plugin.json 明确声明
- 最近维护时间：子目录最近提交 2026-06-23，距运行当天约 3 周，活跃
7. 跟同类 Skills 相比的优势
同一插件仓库（openai/plugins）中还有面向其他办公场景的连接器技能可供对比：
| Skill | 核心场景 | 是否有独立官方 MCP | 与 notion-openai-plugins 的差异 |
|---|---|---|---|
| slack（openai/plugins） | 消息摘要、日报、回复起草 | 否，仅 Codex 专属 Connector | 侧重“消息流”处理，不涉及长期知识沉淀；迁移到非 Codex Agent 需重新对接 |
| atlassian-rovo（openai/plugins） | Jira/Confluence 工单与状态报告 | 否 | 面向项目管理/工单流程，而非通用知识库整理 |
| google-calendar（openai/plugins） | 日程安排、空闲时段查找 | 否 | 场景窄（仅日历），不覆盖研究/会议纪要/知识沉淀 |
| gmail（openai/plugins） | 收件箱分类整理 | 否 | 仅覆盖邮件场景，技能数量少（1 个） |
notion-openai-plugins 的核心差异化：(1) 四个技能覆盖“需求→计划→任务”“研究→简报”“会议→纪要”“对话→知识页”完整的知识工作闭环，而非单点场景；(2) 底层依赖 Notion 官方运维的远程 MCP 服务器，不完全绑定 OpenAI 私有 Connector，理论上更容易迁移到其他支持 MCP 的 Agent。
8. 用户评价
该插件封装本身目前尚无专门针对它的独立评价；以下评价针对的是其工具层所依赖的 Notion 官方 MCP 服务器：
- StackOne（行业分析博客，2026）：指出托管版 MCP“1:1 API 映射方式在处理层级化 block 数据时会产生较高的 token 消耗”，同时提到该服务器“拥有广泛客户端支持（Claude Desktop、Cursor、VS Code Copilot、ChatGPT）”，反映真实采用度
- Notion 官方博客《Notion’s hosted MCP server: an inside look》：说明托管版的限流策略（约 180 次请求/分钟/集成）与设计取舍
- 开源仓库 issue 追踪（makenotion/notion-mcp-server）：截至检索时约 127 个未关闭 issue，有开发者反映托管版对复杂数据库查询（如按条件筛选返回全部匹配页面）的支持不如自建版本灵活
9. 安装使用方式
- Codex CLI/App：在 Connected Apps / Plugins 中搜索并启用「Notion」，完成 OAuth 授权后即可在对话中直接触发 4 个技能（如“帮我把这份 spec 转成实施计划”）
- 手动安装：直接引用插件目录
https://github.com/openai/plugins/tree/main/plugins/notion加入本地或团队插件目录 - 迁移到其他 MCP Agent（如 Claude Code）：可参照 developers.notion.com 官方指南直接添加
mcp.notion.com作为远程 MCP 服务器，本插件的 4 份 SKILL.md 可作为工作流提示词模板参考 - 注意事项：首次使用任一技能会触发 Notion OAuth 授权流程；若中途提示“Tool not found”，SKILL.md 明确建议不要重试，改用 search/fetch 兜底
10. 注意事项
- 已知限制：托管版 Notion MCP 服务器对复杂数据库查询支持有限，复杂场景可能需要改用自建开源版本（
makenotion/notion-mcp-server） - 兼容性：4 份 SKILL.md 的具体工作流文案是为 Codex 撰写，迁移到 Claude Code 等其他 Agent 需自行接线，非开箱即用
- 潜在风险：Notion MCP 生态存在已知的“第三方页面内容提示词注入”风险类别，尤其当工作区包含外部分享/导入页面时；建议仅连接受信任的工作区内容，并参考 Notion 官方发布的 Agent 连接安全最佳实践