Notion MCP Server

MCP服务器概念

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

快速开始

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密钥。

安装说明

• 克劳德桌面：设置>高级>模型上下文协议
• 光标AI：设置>AI>MCP服务器
• Claude.ai（网络版）：配置文件>设置>API和集成>模型上下文协议

可用工具

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

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

替代设置方法

使用环境变量

您可以使用 .env 文件：

1. 创建一个 .env 文件包含：

NOTION_API_KEY=your-notion-integration-key

1. 运行服务器：

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              Show help message
  -v, --version           Show version information
  --verbose               Enable verbose logging
  --env-path 
       Path to .env file
  --api-key          Notion API key
  -y                      Skip confirmation prompts

故障排除

如果遇到“创建客户端失败”错误：

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

常见问题

• “无法访问资源”错误：确保您已将特定的Notion页面或数据库与您的集成共享（请参阅步骤2）
• 集成未出现在共享菜单中：尝试刷新页面或重新启动浏览器
• 能力有限：检查您的集成是否在Notion集成设置中启用了相应的功能

特性

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

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

许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。