Notion MCP Server

🚀 Notion MCP 服务器

Notion MCP 服务器是一个提供官方 Notion SDK 的 Model Context Protocol (MCP) 服务器，它允许 AI 模型与 Notion 工作区进行交互，为 AI 与 Notion 数据的结合提供了便利。

🚀 快速开始

1. 设置你的 Notion 集成

• 访问 https://www.notion.so/my-integrations。
• 创建一个新的集成。
• 复制 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 交互的工具：

• 搜索：查找页面或数据库
• 数据库：查询和检索数据库条目
• 页面：创建、获取和删除页面
• 块：管理页面中的块内容
• 属性：操作页面的属性

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

📦 安装指南

使用环境变量配置

创建一个名为 .env 的文件，并添加以下内容：

NOTION_API_KEY=your-notion-integration-key

然后在项目根目录运行命令以应用设置：

source .env

📄 许可证

本项目根据 Apache License 2.0 许可，具体请参阅 LICENSE 文件。