AI导哈

Notion API MCP服务器

一个AI友好的MCP服务器，用于帮助代理查找、读取、查询和更新Notion工作空间，同时保持响应简洁以适应日常AI工作流程。

  • by suekou
  • TypeScript
  • 本地部署
  • 925 星标
  • 更新于
在 GitHub 查看 suekou/mcp-notion-server

使用说明

MCP服务器概念

为Notion API提供AI友好型MCP服务器。它帮助代理查找、读取、查询和更新Notion工作区，同时保持响应足够紧凑，以适应日常AI工作流程。

此服务器以Notion API为目标 2026-03-11 并使用当前的数据库/数据源模型。它公开了MCP工具、提示、资源、结构化工具结果和可选的MCP应用程序，用于交互式Notion工作流。

亮点

  • 搜索和目标发现 notion_find.
  • 通过以下方式使用稳定的块ID进行紧凑的页面读取 notion_read_page.
  • 数据源架构检查 notion_inspect_data_source.
  • 使用简单值进行模式感知数据源查询和项创建。
  • 用于段落、标题、列表、待办事项、引号、标注、代码块、分隔符和安全Markdown附加的简单页面编辑工具。
  • 用于高级块、页面、数据库、数据源、注释和用户操作的Raw Notion API工具。
  • 可选MCP应用程序：数据源浏览器和页面工作台。

快速开始

将此服务器添加到MCP主机，如Claude Desktop：

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

保存配置后重新启动MCP主机。

安装指南

1.创建概念集成

打开 Notion集成仪表板，然后创建新的内部集成。

2.配置功能

仅授予您需要的功能：

  • 读取内容：搜索、页面读取、数据源检索和查询所需。
  • 插入内容：创建页面/项目和附加块所需。
  • 更新内容：更新页面、块和数据源架构所需。
  • 阅读评论/插入评论：仅评论工具需要。
  • 用户信息：仅在使用用户查找工具时才需要。

要在安装过程中实现完整功能，请启用读取、插入和更新内容。仅当您计划使用这些工具时，才添加评论或用户功能。

3.授予内容访问权限

打开 内容访问 选项卡，然后选择希望MCP服务器读取或编辑的页面或数据库。

您还可以从目标Notion页面或数据库授予访问权限：打开 ... 菜单，选择 连接，然后添加您的集成。

Notion只允许集成访问与其共享的页面和数据库。添加到页面的连接也可以访问该页面的子页面。

4.复制内部集成令牌

复制集成密钥。该值变为 NOTION_API_TOKEN 在MCP主机配置中。

5.配置MCP主机

对于Cursor、Claude Desktop和其他MCP主机，请将此服务器配置添加到MCP设置中：

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

对于本地构建的结账：

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["/absolute/path/to/suekou-mcp-notion-server/build/index.js"],
      "env": {
        "NOTION_API_TOKEN": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

推荐工作流程

  1. 使用 notion_find 查找页面或数据源。
  2. 使用 notion_read_page 用于页面上下文和可编辑块ID。
  3. 使用 notion_inspect_data_source 在查询或创建数据源项之前。
  4. 使用 notion_query_data_source_by_values 和 notion_create_data_source_item_from_values 用于公共数据源工作。
  5. 使用 notion_append_markdown, notion_append_content, notion_update_content，或 notion_update_content_batch 用于正常的页面编辑。
  6. 只有当简化的工具没有涵盖您所需的Notion API形状时，才返回原始JSON工具。

对于开发者

这些参考主要用于开发、定制和高级MCP工作流程：

  • 配置：环境变量、命令行参数、MCP主机示例、开发命令和故障排除。
  • 工具：按工作流区域分组的完整工具参考。
  • 工作流：实用的读、写、数据源、迁移和错误处理指南。
  • MCP应用程序：交互式数据源资源管理器和页面工作台详细信息。

发展

此项目使用Node.js 22或更新版本和pnpm。

pnpm install --frozen-lockfile
pnpm run build
pnpm test

在本地开发过程中使用MCP检查器：

pnpm run inspector

许可证

此MCP服务器根据MIT许可证获得许可。这意味着您可以根据MIT许可证的条款和条件自由使用、修改和分发软件。有关更多详细信息，请参阅项目存储库中的LICENSE文件。

相关 MCP