适合谁
- 需要让 AI 代理访问 Notion 工作区的用户
- 需要进行常见页面编辑和数据源操作的 MCP 工作流
- 希望使用紧凑响应和简化工具的 Notion API 场景
N
54FMRS · D
MIT 许可的 Notion MCP 服务器，提供从搜索、读取到数据源操作和页面编辑的常见工作流工具。证据显示其通过 stdio 配置运行，适合已明确配置 Notion 集成权限的 AI 工作流；仓库并非 Notion 官方维护，因此不属于官方服务器。
一个连接 Notion 与 MCP 兼容客户端的 MCP 服务器，支持查找、读取、查询和更新 Notion 工作区。它面向 Notion API 2026-03-11，采用当前的数据源模型，并提供紧凑响应、结构化工具结果、提示、资源以及可选的交互式 MCP Apps。
工具能力
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
更新页面内容。
notion_update_content_batch
批量更新页面内容。
安装接入
在 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"}}}}
选型与风险
不适合谁
- 不使用 Notion 的工作流
- 只需要读取未向该集成授权内容的用户
- 需要简化工具未覆盖的高级 API 形状且不愿使用原始 JSON 工具的场景
所需权限
- 读取内容：搜索、读取页面、获取数据源和查询所需
- 插入内容：创建页面或项目以及追加区块所需
- 更新内容：更新页面、区块和数据源架构所需
- 读取评论和插入评论：仅评论工具所需
- 用户信息：仅用户查询工具所需
- 集成只能访问已与其共享的页面和数据库
风险与副作用
- 启用插入或更新能力后，代理可以创建或修改已授权的 Notion 内容
- 授权范围过大可能使服务器访问不必要的页面或数据库
- 缺少所需 Notion 能力或内容授权时，相关操作无法正常完成
- API 目标为 Notion 2026-03-11，依赖当前的数据源模型
常见排障
- 确认 NOTION_API_TOKEN 已设置为正确的内部集成令牌
- 保存配置后重启 MCP 主机
- 确认集成已启用所需的读取、插入或更新能力
- 确认目标页面或数据库已在 Content access 中授权，或已通过 Connections 添加集成
- 需要完整功能时检查读取、插入和更新内容能力是否均已启用
使用场景
查找和读取 Notion 页面
检查、查询和创建数据源项目
追加段落、标题、列表、待办、引用、标注、代码块和分隔线
更新页面内容并执行批量编辑
通过可选 MCP Apps 使用 Data Source Explorer 和 Page Workbench
支持客户端
Claude Desktop完整支持
Cursor完整支持