Notion MCP Server

社区

面向 AI 工作流的 Notion MCP 服务器

分类: 团队协作第 27 / 55
Stars: ★ 921 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 22+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 3 个月前
工具数: 9

54FMRS · D

MIT 许可的 Notion MCP 服务器，提供从搜索、读取到数据源操作和页面编辑的常见工作流工具。证据显示其通过 stdio 配置运行，适合已明确配置 Notion 集成权限的 AI 工作流；仓库并非 Notion 官方维护，因此不属于官方服务器。

最强项 · 安装易用性 13/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

11/20

维护活跃度

9/20

文档质量

12/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: README 描述了 MCP 初始化后的工具、提示、资源和结构化结果，但未提供服务器清单、源文件、CI 或已提交测试，无法静态验证启动、握手、工具列表与实际实现的一致性。README 提到 pnpm build 和 test，但不是可审查的执行证据，因此按静态校准扣分。
安全与权限 11/20: 凭据通过 NOTION_API_TOKEN 环境变量传入，且文档说明 Notion 内容访问共享和按能力授权，体现了基本的权限边界与最小权限意识。扣分原因是服务器包含更新、创建、原始 API 及评论操作，README 未证明危险操作需要确认、未说明完整数据流或网络边界，也未提供代码级凭据处理证据。
维护活跃度 9/20: 仓库未归档，使用 MIT 许可证，且项目描述包含 Node.js 22、pnpm 和开发命令。没有提供发行记录、提交活跃度、依赖更新策略、问题响应情况或安全响应渠道证据，因此只能给出中低分。
文档质量 12/20: README 提供了安装配置、Notion 集成创建、能力授权、内容访问、主流客户端配置、推荐工作流和文档分层链接。扣分原因是工具参数、限制、成本、故障排查细节主要依赖未提供的文档，且清单和实现未缓存，无法全面复核能力声明。
安装易用性 13/20: 提供 npx 一键配置和本地 node 配置，并覆盖 Claude Desktop、Cursor 等客户端，步骤从集成创建到连接配置较清晰。扣分原因是要求 Node.js 22 和 pnpm，平台兼容性、构建产物和实际可启动性没有源文件或 CI/测试证据验证。

静态评测 · 未实际运行收录于 2026-07-29

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要让 AI 代理访问 Notion 工作区的用户
需要进行常见页面编辑和数据源操作的 MCP 工作流
希望使用紧凑响应和简化工具的 Notion API 场景

不适合谁

不使用 Notion 的工作流
只需要读取未向该集成授权内容的用户
需要简化工具未覆盖的高级 API 形状且不愿使用原始 JSON 工具的场景

所需权限

读取内容：搜索、读取页面、获取数据源和查询所需
插入内容：创建页面或项目以及追加区块所需
更新内容：更新页面、区块和数据源架构所需
读取评论和插入评论：仅评论工具所需
用户信息：仅用户查询工具所需
集成只能访问已与其共享的页面和数据库

风险与副作用

启用插入或更新能力后，代理可以创建或修改已授权的 Notion 内容
授权范围过大可能使服务器访问不必要的页面或数据库
缺少所需 Notion 能力或内容授权时，相关操作无法正常完成
API 目标为 Notion 2026-03-11，依赖当前的数据源模型

安装接入

准备工作

运行环境：Node.js 22+

NOTION_API_TOKEN 必填密钥 Notion 内部集成的集成密钥（secret_...），在 Notion 集成仪表板（notion.so/profile/integrations）创建集成后复制，并需在 Content access 中授权页面访问。

在 MCP 主机配置中加入 install_config，将 NOTION_API_TOKEN 替换为 Notion 内部集成令牌，然后重启 MCP 主机。先在 Notion 集成设置中创建内部集成、配置所需能力，并在 Content access 中授权目标页面或数据库。也可以在目标页面或数据库的 Connections 菜单中添加该集成。

claude_desktop_config.json

{"mcpServers":{"notion":{"command":"npx","args":["-y","@suekou/mcp-notion-server"],"env":{"NOTION_API_TOKEN":"your-integration-token"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add notion -e NOTION_API_TOKEN=your-integration-token -- npx -y @suekou/mcp-notion-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

将配置加入 MCP 主机并重启后，在客户端工具列表中确认 notion_find、notion_read_page 等 notion_ 前缀工具已出现；然后让 AI 用 notion_find 搜索你的工作区，如能返回页面或数据源结果即证明连接成功。

常见排障

确认 NOTION_API_TOKEN 已设置为正确的内部集成令牌
保存配置后重启 MCP 主机
确认集成已启用所需的读取、插入或更新能力
确认目标页面或数据库已在 Content access 中授权，或已通过 Connections 添加集成
需要完整功能时检查读取、插入和更新内容能力是否均已启用

试试这样问

连接成功后，可以直接对 AI 助手这样说：

用 notion_find 帮我在 Notion 工作区里找一下关于项目计划的页面
读取我刚找到的那个页面，给我一个内容摘要
检查一下这个数据源的 schema，然后按状态筛选出所有未完成的条目
在这篇文档末尾追加一段 Markdown，包含一个待办清单

工具能力 9

notion_find 只读

查找页面或数据源。

notion_read_page 只读

读取页面内容，并提供稳定的区块 ID。

notion_inspect_data_source 只读

检查数据源架构。

notion_query_data_source_by_values 只读

按简单值查询数据源。

notion_create_data_source_item_from_values 写入

使用简单值创建数据源项目。

notion_append_markdown 写入

向页面安全追加 Markdown。

notion_append_content 写入

向页面追加常见内容区块。

notion_update_content 写入

更新页面内容。

展开其余 1 个工具

notion_update_content_batch 写入

批量更新页面内容。

使用场景

查找和读取 Notion 页面

检查、查询和创建数据源项目

追加段落、标题、列表、待办、引用、标注、代码块和分隔线

更新页面内容并执行批量编辑

通过可选 MCP Apps 使用 Data Source Explorer 和 Page Workbench

支持客户端

Claude Desktop

Cursor

依据项目文档列出，未经本站实测。

详细介绍

一个连接 Notion 与 MCP 兼容客户端的 MCP 服务器，支持查找、读取、查询和更新 Notion 工作区。它面向 Notion API 2026-03-11，采用当前的数据源模型，并提供紧凑响应、结构化工具结果、提示、资源以及可选的交互式 MCP Apps。