Notion MCP：让智能体搜索和编辑你的 Notion 工作区

会议纪要、需求文档、任务看板都在 Notion 里，智能体却看不到，每次只能复制粘贴。Notion 官方提供两种 MCP：一个是 Notion 托管的远程服务器，OAuth 登录、权限跟着你的账号走；另一个是 GitHub 上这个可以自己跑的开源版本。Notion 现在明确推荐前者，这个仓库已经不再积极维护。

能做什么

• 搜索：远程版的 notion-search 按关键词、位置、创建人、日期等过滤，工作区开通 Notion AI 时还能用 notion-ai-search 跨已连接的第三方应用做语义搜索。
• 读写页面：notion-fetch 读取页面、数据库和视图，notion-create-pages、notion-update-page 用 Markdown 创建和修改内容。
• 数据库查询：notion-query-data-sources 按视图或条件查询数据库条目。
• 自托管版：开源版提供 22 个从 Notion API 直接映射的工具，用内部集成令牌连接，需要手动把页面共享给集成。

适合谁

• 用 Notion 做知识库或项目管理，想让 Claude、Cursor 直接查文档、更新任务状态的团队。
• 需要把会议记录整理成 Notion 页面、或从数据库里汇总进度的项目经理。

接入方式

推荐的远程版，Claude Code 添加后在会话里运行 /mcp 完成 OAuth 登录：

claude mcp add --transport http notion https://mcp.notion.com/mcp

确实需要本地运行时，开源版的配置（令牌来自 Notion 的内部集成设置）：

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_****"
      }
    }
  }
}

编辑点评

Notion 类的社区 MCP 有好几个，但官方远程版在体验上明显领先：不用管令牌和页面共享，返回的是省 token 的 Markdown，权限和你在 Notion 里看到的一致。这个条目链接的是开源仓库，因为它是 Notion 官方在 GitHub 上的 MCP 入口，但请注意仓库首页的声明：本地版不再积极支持，issue 不再有人看，未来可能下线。只有在必须自托管、不能走 OAuth 的场景才考虑它，而且建议给集成令牌只开“读取内容”权限。远程版的部分搜索能力需要付费的 Notion AI。开源版许可证为 MIT，截至 2026-10-06 约 4700 star。