MCP 服务器

Notion MCP Server

镜子 (jìng zi)

MCP-Mirror

开发者工具

访问服务器

README

Notion MCP 服务器

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

快速开始

1. 设置您的 Notion 集成

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

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

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

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

注意： 集成只能访问已明确与其共享的页面和数据库。父页面不会自动授予对子页面的访问权限。

3. 添加到您的 AI 助手

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

命令行格式

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

JSON 配置格式

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

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

设置说明

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

可用工具

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

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

其他设置方法

使用环境变量

除了直接传递 API 密钥之外，您还可以使用 .env 文件：

创建一个包含以下内容的 .env 文件：

NOTION_API_KEY=your-notion-integration-key

运行服务器：

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

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

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

{
  "name": "Notion",
  "command": {
    "args": ["@ramidecodes/mcp-server-notion@latest", "-y"],
    "env": {
      "NOTION_API_KEY": "your-notion-integration-key"
    },
    "executable": "npx"
  }
}

命令行选项

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