notion-mcp-server
活跃·★ 4.7k·MIT·更新于 2026-10-29
★ 必备神器★ 时下流行
这个仓库是 Notion 官方的本地 MCP 服务器,对接 Notion API。你需要在 Notion 里创建一个内部集成,把它可以访问的页面和数据库连接进来(或逐页授权),然后用集成 token 通过 npx 或 Docker 运行服务器。只给集成「读取内容」权限,就能得到只读 token。
2.0 版改用 2025-09-03 版的 Notion API,用 data source 取代 database 作为主要抽象。四个数据库工具被替换为对应的 data source 工具,新增两个工具(列出 data source 模板、移动页面),总数变为 21 个。工具在启动时自动发现,所以客户端会自动拿到新名称,但写死旧工具名的提示词需要更新。
README 开头有一条重要说明:Notion 现在提供远程 Notion MCP,支持 OAuth 登录,工具也针对智能体做了优化;Notion 优先并只积极支持远程服务器,这个本地仓库将来可能停用,这里的 issue 和 PR 也不会被积极处理。我们的数据显示最近一次推送是 2026-09-20。
#Notion#MCP#AI 代理#API#Docker
01
功能特性
01实现Notion API的MCP服务器
02为AI代理量身定制的工具(例如,Markdown编辑)
03为AI交互优化令牌消耗
04支持Notion API 2025-09-03及数据源抽象
05AI客户端自动发现工具
02
为什么选择它
+Notion 官方服务器,可用 npx 或 Docker 在本地运行。
+访问范围限定在连接到集成的页面和数据库,也可以使用只读 token。
+21 个基于当前 data source API 的工具,启动时自动发现。
03
权衡点
!Notion 表示这个仓库将来可能停用,并优先支持远程 Notion MCP。
!README 说明这里的 issue 和 PR 不会被积极处理。
!你需要自己管理集成 token,而远程服务器使用标准 OAuth。
!v2.0 删除了旧的数据库工具,写死旧工具名的提示词会失效。
05
维护状况检查
活跃检查日期: 2026-11-05
- 最近提交
- 2026-10-29
- 近 90 天提交数
- 8
- 近 90 天发布数
- 0
- 最新发布
- v2.1.0 (2026-01-31)
- 未关闭 issue
- 210
- 近期 issue 至少有一条评论的比例
- 10/24
近 12 周每周提交数
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #106 401 using mcp.notion.com/mcp22 条评论 · 2025-08-11
- #69 Gemini-Cli reports an error with the Notion MCP21 条评论 · 2025-06-26
- #82 Parameter serialization bug: Object parameters received as strings in create-pages and move-pages tools18 条评论 · 2025-07-15
- #269 Internal Server Error on OAuth callback when connecting via Claude.ai (Hosted MCP)16 条评论 · 2026-04-16
- #191 Feature Request: Support local file upload for images and files14 条评论 · 2026-01-28
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
04
适合谁
适合选它的情况
- 想要在本地用 npx 或 Docker 运行的 Notion 服务器,使用内部集成 token。
- 想把访问范围限定在连接到集成的页面和数据库,或者使用只读 token。
- 你的流程基于 Notion API 的 data source:v2.0 基于 2025-09-03 版 API,有 21 个工具。
建议换别的情况
- 你想用官方重点支持的方案:README 说 Notion 优先支持远程 Notion MCP,这个仓库将来可能停用。
- 你需要 issue 得到回应:README 说明这里的 issue 和 PR 不会被积极处理。
- 你不想自己管理 token:远程 Notion MCP 改用标准 OAuth。
06
与同类的区别
PipesHub 把 Notion 和其他 50 多个来源一起索引,提供带引用、按权限过滤的搜索。Notion 服务器直接读写 Notion 页面和 data source。
07
兼容性
Cursor
支持
已通过文档验证
Claude Desktop
支持
已通过文档验证
Zed
支持
已通过文档验证
Docker
支持
已通过文档验证
Web Applications
支持
已通过文档验证
08
快速开始
1
$ npx @notionhq/notion-mcp-server
09
使用场景
↳AI代理与Notion内容交互
↳通过AI命令自动化Notion任务
↳开发与Notion API的自定义AI集成
10
同类工具
收录于以下清单
评论
登录后发表评论
暂无评论,来发表第一条吧