makenotion/notion-mcp-server

这是什么？

核心功能

• 01将 Notion API 操作封装为 MCP 工具，供 AI 客户端调用。
• 02支持 stdio 和 Streamable HTTP 两种传输方式。
• 032.0.0 版本可以以 Markdown 读取和编辑页面内容。
• 04支持数据源的创建、更新和查询。
• 05通过 NOTION_TOKEN 或 OPENAPI_MCP_HEADERS 配置集成 Token。
• 06提供可选的按请求 Token 透传，便于一个部署服务多个集成。

适用场景

• 让 AI 助手搜索并总结 Notion 工作区中的页面。
• 在编辑器中通过自然语言指令自动创建页面或添加评论。
• 搭建 Notion 与内部 AI Agent 之间的自托管连接。
• 使用只读集成 Token，限制 AI 客户端的修改权限。

快速上手

1. 1

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

2. 2

   将需要使用的页面连接到该集成

3. 3

   使用 npx 将 MCP 配置（含 NOTION_TOKEN）添加到你的客户端

   npx -y @notionhq/notion-mcp-server

使用前须知

• !Notion 推荐改用其官方托管的 Remote Notion MCP，本仓库已不再积极维护或提供支持。
• !议题和拉取请求不会被积极处理，项目未来可能被停止维护。
• !搜索仅支持关键词，页面内容工具相比托管版本功能有限。
• !需要手动配置集成令牌并共享页面。

标签

常见问题

notion-mcp-server 是什么？

让 AI 助手通过 Notion API 读写 Notion 工作区的自托管 MCP 服务器，官方已推荐改用托管版。 这是一个基于 MCP（Model Context Protocol）协议的服务器，封装了 Notion API，把搜索、读取和创建页面、查询数据库与数据源、添加评论等操作提供为工具，供 Claude Desktop、Cursor、Zed 等 AI 客户端调用。默认通过 stdio 本地运行，也可以以 Streamable HTTP 方式启动并使用 Bearer Token 鉴权。访问范围由 Notion 内部集成的 Token 决定，只有明确连接到该集成的页面才能被读取或修改。

notion-mcp-server 可以免费使用吗？用的什么许可证？

notion-mcp-server 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

notion-mcp-server 还在维护吗？

活跃维护中。notion-mcp-server 最近一次提交是在 2026年9月20日。

notion-mcp-server 适合用来做什么？

让 AI 助手搜索并总结 Notion 工作区中的页面。 在编辑器中通过自然语言指令自动创建页面或添加评论。 搭建 Notion 与内部 AI Agent 之间的自托管连接。 使用只读集成 Token，限制 AI 客户端的修改权限。

notion-mcp-server 怎么安装和运行？

在 Notion 中创建内部集成并复制其令牌 将需要使用的页面连接到该集成 使用 npx 将 MCP 配置（含 NOTION_TOKEN）添加到你的客户端: npx -y @notionhq/notion-mcp-server

在哪里获取 notion-mcp-server？

源代码和安装说明在 GitHub 上：https://github.com/makenotion/notion-mcp-server