一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | claude-code-notion-plugin | 仓库名 |
| 作者/维护者 | Notion 官方（GitHub 组织 makenotion）；Skills 由 Notion 编写，MCP Server 由 Notion 提供，插件打包规范由 Anthropic 制定 |
README 致谢 + GitHub 组织归属 |
| 来源链接 | https://github.com/makenotion/claude-code-notion-plugin | — |
| 许可证 | 仓库内无 LICENSE 文件，README 亦未声明许可条款 | GitHub API（license 接口返回 404）+ 仓库根目录实测 |
| GitHub Stars / Forks | 445 / 62 | GitHub API |
| 最近提交 | 2026-01-22（约 6 个月前） | GitHub API |
| 最新版本 | 未见 Release/Tag（仓库未使用版本标签，随主分支更新） | GitHub API |
| 安装方式 | 见第十章 | 仓库 README |
二、功能介绍与亮点
claude-code-notion-plugin 是 Notion 官方为 Claude Code 打造的工作区集成插件，一次安装打包三类能力：
- Notion MCP Server：通过
https://mcp.notion.com/mcp（Notion 官方托管端点）以 OAuth 方式接入，让 Claude 能安全地搜索、读取、创建与更新 Notion 页面、数据库及区块 - 4 个专用 Skill：知识沉淀（Knowledge Capture，把对话中的结论整理成结构化文档并存入合适的 wiki/数据库）、会议纪要（Meeting Intelligence）、调研文档（Research Documentation）、规格到实现（Spec to Implementation）
- 9 个斜杠命令：
/Notion:search、/Notion:create-page、/Notion:database-query、/Notion:create-task、/Notion:create-database-row、/Notion:find，以及/Notion:tasks:setup、:build、:plan、:explain-diff四个任务类子命令
亮点：Notion 官方亲自出品并维护，而非第三方逆向对接；认证走 OAuth，无需用户手动申请、粘贴 API Key；仓库结构清晰（skills/、commands/、.mcp.json 三部分各司其职），逐一实测与 README 描述完全一致。
三、适用场景
固定分类：集成与工作流自动化
适用于把 Notion 作为团队知识库或任务看板、日常用 Claude Code 编程或处理事务的初中级用户：开发过程中随手把讨论结论存进 Notion wiki、把会议内容整理成结构化纪要、在 Notion 数据库里创建与跟踪任务、把某个 Notion 规格文档转成可执行的开发计划。不需要额外学习 Notion API，用自然语言描述需求即可。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方打包为 Claude Code 插件市场条目，一条命令安装，Skill/命令/MCP 三件套均按 Claude Code 插件规范组织 |
| Codex | 未验证 | 底层 Notion MCP Server 走标准 HTTP MCP 协议，理论上可被任何兼容 MCP 的客户端单独接入，但插件整体（含 Skill 与斜杠命令）是 Claude Code 插件市场专属打包格式，未见官方为 Codex 提供对应方案，已抓取材料未提及，未做实际验证 |
| OpenClaw | 未验证 | 已抓取材料未提及，未为此单独搜索 |
| Hermes Agent | 未验证 | 已抓取材料未提及，未为此单独搜索 |
五、推荐理由
Notion 官方亲自出品的 Claude Code 集成插件，OAuth 免密钥接入，一次安装即获知识沉淀、会议纪要等四项实用技能
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | Notion 是知识管理/协作领域一线 SaaS 厂商，本插件为其官方亲自出品并具名维护；但从独立热度看仅 445 Stars、62 Forks，未见第三方平台（Reddit/Hacker News）出现专门讨论该插件的帖子，故不给满分 |
| 可用性 | 8 | /plugin marketplace add + /plugin install 两条命令即可安装，无需重启外的额外步骤；OAuth 授权免去手动申请与保管 API Key 的麻烦；README 对 4 个 Skill、9 个命令均有清晰说明。扣分点：最近一次提交在约 6 个月前，维护节奏偏慢 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 仓库内无可执行脚本，.mcp.json 仅声明一个 HTTP 类型的 MCP 端点，不存在本地进程调起或 shell 命令执行 |
| ② 运行时联网外发数据 | 仅与 Notion 官方托管的 https://mcp.notion.com/mcp 通信，目标透明且为厂商自有域名 |
| ③ API Key/凭据要求及存储方式 | 走 OAuth 授权流程，用户无需手动生成或粘贴 API Key，凭据由 Notion 官方 OAuth 体系管理 |
| ④ 可疑指令/Prompt Injection 迹象 | 已实测拉取 4 个 Skill 目录结构与其中一份 SKILL.md 全文、.mcp.json 全文，均为常规任务指引，未发现诱导执行额外操作或外发数据的文字 |
| ⑤ 作者/组织信誉 | GitHub 组织 makenotion 为 Notion 官方账号，README 具名致谢，非匿名或不明来源 |
| ⑥ License 是否明确 | 仓库根目录无 LICENSE 文件，README 未声明许可条款——官方产品但条款不透明，是本次评分的主要扣分项 |
| ⑦ 最近维护时间 | 最近提交约 6 个月前，未发现明确弃置迹象（issue 区仍有 18 个开放讨论） |
七、跟同类 Skills 相比的优势
| 方案 | 核心定位 | 认证方式 | 与本插件的差异 |
|---|---|---|---|
| claude-code-notion-plugin（本推荐） | Notion 官方出品，Skill + 命令 + MCP 三件套打包 | OAuth | — |
| notion-openai-plugins（OpenAI 插件市场） | OpenAI 官方插件生态里的 Notion 连接器，服务于 OpenAI 侧 Agent 生态 | 需自行配置认证 | 面向 OpenAI 生态而非 Claude Code 原生插件市场，不提供本插件特有的知识沉淀/会议纪要等 Skill 层能力 |
| Zapier workflows-create（Zapier 官方 Agent Skills） | 通用型跨应用工作流触发器，Notion 只是其可连接的众多 App 之一 | Zapier 账号 + 各 App 授权 | 定位是“连接一切”的通用自动化平台，深度不及官方原生 Notion 插件，但覆盖面远超单一 App |
| team-attention/notion-skills-for-claude（社区） | 面向 Notion 工作流的分步指南型 Skill 集合 | 依赖用户自行配置 Notion API | 非 Notion 官方出品，未经官方认证与维护承诺，与本插件的官方背书不在同一可信度量级 |
差异化核心：同样连接 Notion，官方插件的优势在于认证方式（OAuth 免密钥）与责任主体（Notion 自己维护、自己对接口变更负责），而非官方或跨平台方案通常需要用户自行申请并保管 API 凭据，长期可靠性依赖第三方维护者的持续投入。
八、用户评价
该技能目前在第三方平台（Reddit、Hacker News）尚无经核实的具名用户评价。
九、其他补充
无。
十、安装使用方式
在 Claude Code 中依次运行：
/plugin marketplace add makenotion/claude-code-notion-plugin
/plugin install notion-workspace-plugin@notion-plugin-marketplace安装完成后重启 Claude Code 使插件生效。首次使用需按提示完成 Notion OAuth 授权（浏览器弹窗登录并选择要授权的工作区），之后即可直接用自然语言描述需求（如“把刚才讨论的结论存到 Notion”）或使用 /Notion: 开头的斜杠命令。
十一、注意事项
- 仓库未声明开源许可证，商用或二次分发前建议自行与 Notion 确认条款
- 最近一次代码提交约 6 个月前，功能迭代节奏偏慢，使用前建议先验证当前 Notion API 版本是否仍与插件兼容
- 深度绑定 Claude Code 插件市场机制，对 Codex 未提供官方打包方案；对 OpenClaw、Hermes Agent 的兼容性未见官方说明，本报告未验证
- OAuth 授权范围覆盖整个被选中的 Notion 工作区，建议企业用户在授权前确认工作区权限边界是否符合内部数据管理要求