Notion MCP Server

一个通过官方Notion SDK暴露接口的Model Context Protocol (MCP)服务器，允许AI模型与Notion工作区进行交互。

<a href="https://glama.ai/mcp/servers/bjc5iac7gt"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=1561965309,3014473823&fm=3081&app=3081&f=PNG?w=760&h=400" 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替换为你在第一步中获取的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                      跳过确认提示

故障排除

如果你遇到“无法创建客户端”的错误：

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

常见问题

• “无资源访问权限”错误: 确保你已将特定的Notion页面或数据库与你的集成共享（参见步骤2）
• 集成未出现在分享菜单中: 尝试刷新页面或重启浏览器
• 功能有限: 检查你的集成是否在Notion集成设置中启用了适当的权限

特性

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

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

许可证

本项目根据Apache许可证2.0发布 - 详情请参阅LICENSE文件。 </中文翻译>