Repolode
suekou

suekou/mcp-notion-server

让 AI 智能体通过 Notion API 查找、读取、查询和编辑 Notion 页面与数据库的 MCP 服务器。

Star
923
Fork
181
未关闭 Issue
10
最近提交
3个月前

这是什么?

这是一个 Model Context Protocol 服务器,可将 Notion 工作区接入 Claude Desktop、Cursor 等支持 MCP 的客户端。它面向 Notion API 2026-03-11 版本,使用当前的数据库与数据源模型,返回结果经过精简,并为块提供稳定 ID,便于后续编辑。

服务器提供查找页面或数据源、读取页面内容、查看数据源结构、按字段值查询或新建条目等工具。简化的编辑工具支持段落、标题、列表、待办、引用、提示框、代码块、分隔线以及 Markdown 追加。对于高级的块、页面、数据库、评论和用户操作,还提供原始 Notion API 工具。

使用前需要创建 Notion 内部集成,授予读取、插入或更新权限,并将目标页面或数据库分享给该集成。服务器通过 npx 运行,只需配置 NOTION_API_TOKEN 环境变量;可选的 MCP Apps 还提供数据源浏览器和页面工作台界面。

核心功能

  • 01通过 notion_find 搜索页面和数据源。
  • 02以精简形式读取页面,并提供稳定的块 ID 便于编辑。
  • 03在查询或新建条目前查看数据源结构。
  • 04使用简单值查询和创建数据源条目。
  • 05支持段落、标题、列表、待办、代码块及 Markdown 追加等页面编辑。
  • 06提供原始 Notion API 工具,用于高级的块、数据库、评论和用户操作。

适用场景

  • 让 Claude Desktop 或 Cursor 中的 AI 助手读取并总结 Notion 笔记。
  • 在智能体工作流中查询 Notion 数据库并新增条目。
  • 将生成的 Markdown 内容自动追加到 Notion 页面。
  • 通过 AI 驱动的编辑流程批量更新页面块。

快速上手

  1. 1

    创建 Notion 内部集成并复制其令牌

  2. 2

    在 MCP 宿主配置中添加该服务器并设置 NOTION_API_TOKEN

    npx -y @suekou/mcp-notion-server
  3. 3

    保存配置后重启 MCP 宿主

使用前须知

  • 每个 Notion 页面或数据库都必须先明确共享给该集成,服务器才能访问。
  • 需要 Notion 集成令牌;开发时需要 Node.js 22 或更高版本。

收录于专题

标签

常见问题

mcp-notion-server 是什么?
让 AI 智能体通过 Notion API 查找、读取、查询和编辑 Notion 页面与数据库的 MCP 服务器。 这是一个 Model Context Protocol 服务器,可将 Notion 工作区接入 Claude Desktop、Cursor 等支持 MCP 的客户端。它面向 Notion API 2026-03-11 版本,使用当前的数据库与数据源模型,返回结果经过精简,并为块提供稳定 ID,便于后续编辑。
mcp-notion-server 可以免费使用吗?用的什么许可证?
mcp-notion-server 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
mcp-notion-server 还在维护吗?
半年内有更新。mcp-notion-server 最近一次提交是在 2026年7月31日。
mcp-notion-server 适合用来做什么?
让 Claude Desktop 或 Cursor 中的 AI 助手读取并总结 Notion 笔记。 在智能体工作流中查询 Notion 数据库并新增条目。 将生成的 Markdown 内容自动追加到 Notion 页面。 通过 AI 驱动的编辑流程批量更新页面块。
mcp-notion-server 怎么安装和运行?
创建 Notion 内部集成并复制其令牌 在 MCP 宿主配置中添加该服务器并设置 NOTION_API_TOKEN: npx -y @suekou/mcp-notion-server 保存配置后重启 MCP 宿主
在哪里获取 mcp-notion-server?
源代码和安装说明在 GitHub 上:https://github.com/suekou/mcp-notion-server

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目