让 AI 助手通过 Notion API 读写 Notion 工作区的自托管 MCP 服务器,官方已推荐改用托管版。
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
创建 Notion 内部集成并复制其令牌
- 2
在 MCP 宿主配置中添加该服务器并设置 NOTION_API_TOKEN
npx -y @suekou/mcp-notion-server - 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 数据每日更新。
相关项目
Model Context Protocol 参考服务器集合,为 LLM 客户端提供文件、Git、网页抓取、记忆等工具和数据访问能力。
官方 TypeScript SDK,用于构建 Model Context Protocol 服务端与客户端,为 LLM 应用提供标准化上下文。
用 TypeScript 构建 MCP 服务器、带 React 视图的 MCP 应用和客户端的全栈框架,内置调试器和 CLI。
一组远程 MCP 服务器,让 Cursor、Claude 等 AI 客户端用自然语言查询和管理 Cloudflare 账户与服务。
官方 Python SDK,用于构建 Model Context Protocol 服务端和客户端,连接 LLM 应用与工具、数据和提示词。