Notion MCP 服务器

一个模型上下文协议 (MCP) 服务器，它公开了官方 Notion SDK，允许 AI 模型与 Notion 工作区进行交互。

<a href="https://glama.ai/mcp/servers/bjc5iac7gt"> <img width="380" height="200" src="https://glama.ai/mcp/servers/bjc5iac7gt/badge" alt="Notion Server MCP server" /> </a>

快速开始

1. 设置您的 Notion 集成

1. 前往 https://www.notion.so/my-integrations
2. 创建一个新的集成
3. 复制 API 密钥

2. 将您的 Notion 页面连接到集成

为了让您的集成访问 Notion 内容，您需要显式地与它共享您的页面或数据库：

1. 导航到您想要通过集成访问的 Notion 页面或数据库
2. 点击右上角的“分享”按钮
3. 在“添加人员、群组或集成”字段中，从下拉列表中选择您的集成
4. 点击“邀请”
5. 对您想要使其可访问的每个页面或数据库重复此操作

注意： 集成只能访问已明确与之共享的页面和数据库。子页面自动继承来自父页面的访问权限。

3. 添加到您的 AI 助手

您可以使用以下任一配置格式将此 MCP 服务器添加到 Claude Desktop、Cursor AI 或 Claude.ai：

命令行格式

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON 配置格式

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

将 your-notion-integration-key 替换为步骤 1 中的 API 密钥。

设置说明

• Claude Desktop: 设置 > 高级 > 模型上下文协议
• Cursor AI: 设置 > AI > MCP 服务器
• Claude.ai (Web): 个人资料 > 设置 > API & 集成 > 模型上下文协议

可用工具

该服务器提供了与 Notion 交互的工具：

• 搜索: 查找页面或数据库
• 数据库: 查询和检索数据库条目
• 页面: 创建、检索和更新页面
• 块: 管理内容块（段落、列表等）
• 用户: 列出用户并获取用户信息
• 评论: 创建和列出评论
• 链接预览: 为 URL 创建链接预览

替代设置方法

使用环境变量

您可以不直接传递 API 密钥，而是使用 .env 文件：

1. 创建一个 .env 文件，内容如下：

NOTION_API_KEY=your-notion-integration-key

2. 运行服务器：

npx @ramidecodes/mcp-server-notion@latest -y

带有环境变量的 JSON 配置（适用于 Claude Desktop）

您也可以在 JSON 配置格式中使用环境变量：

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

命令行选项

OPTIONS:
  -h, --help              显示帮助信息
  -v, --version           显示版本信息
  --verbose               启用详细日志记录
  --env-path <path>       .env 文件的路径
  --api-key <key>         Notion API 密钥
  -y                      跳过确认提示

故障排除

如果您遇到“Failed to create client”错误：

• 在 Windows 上，尝试在 npx 命令之前使用 cmd /c
• 在 macOS/Linux 上，尝试使用 npx 的完整路径
• 在将其添加到您的 AI 助手之前，在终端中测试该命令

常见问题

• “No access to resource”错误: 确保您已与您的集成共享特定的 Notion 页面或数据库（请参阅步骤 2）
• 集成未出现在共享菜单中: 尝试刷新页面或重新启动浏览器
• 功能有限: 检查您的集成是否在 Notion 集成设置中启用了适当的功能

特性

• 通过官方 SDK 提供完整的 Notion API 支持
• 符合 MCP 标准，可实现无缝 AI 集成
• 适用于所有 Notion 操作的综合工具
• 具有详细消息的强大错误处理
• 使用环境变量轻松配置

有关每个工具的详细文档，请参阅 工具文档。

许可证

该项目根据 Apache License 2.0 获得许可 - 有关详细信息，请参阅 LICENSE 文件。