Notion MCP Server

Notion MCP Server 是一个实现了 Model Context Protocol (MCP) 协议的服务器，用于连接 Notion API，使 AI 助手（如 Cursor 或 Claude）能够通过标准化接口与 Notion 内容进行交互。该工具支持搜索、创建页面、添加评论等操作，适用于需要 AI 自动管理 Notion 内容的场景。

核心功能

Notion MCP Server 提供了以下核心功能，使 AI 助手能够与 Notion 内容进行交互：

• 内容搜索：AI 可以搜索 Notion 页面和数据库中的内容。
• 创建页面：AI 可以在指定位置创建新的 Notion 页面。
• 添加评论：AI 可以在现有页面上添加评论。
• 读取内容：AI 可以获取特定页面的内容。

安装方法

Notion MCP Server 支持多种安装方式，包括使用 npm 或 Docker，具体步骤如下：

1. 在 Notion 中创建集成

访问 Notion 集成页面，创建一个新的内部集成，并获取 API 密钥。建议创建只读集成以增强安全性。

2. 配置客户端

在 Cursor 或 Claude 的配置文件中添加 MCP 服务器信息。以下是两种配置方式：

使用 npm

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

使用 Docker

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "mcp/notion"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

3. 将内容连接到集成

在 Notion 中，导航到您要连接的内容（页面或数据库），然后使用侧边栏中的“设置”菜单将该内容连接到之前创建的集成。

使用方法

Notion MCP Server 提供了多种 API 接口，支持通过 HTTP 请求与 Notion 内容进行交互。以下是几个常见使用示例：

添加评论

POST http://localhost:19000/comments
Content-Type: application/json

{
  "parent": "page_id",
  "content": "这是一个测试评论。"
}

获取页面内容

GET http://localhost:19000/page_content?page_id=page_id

搜索内容

POST http://localhost:19000/search
Content-Type: application/json

{
  "query": "要搜索的内容"
}

使用场景

Notion MCP Server 适用于以下场景：

• 需要 AI 助手自动整理和管理 Notion 内容。
• 希望在 Notion 页面上自动添加评论或创建新页面。
• 需要通过自然语言指令与 Notion 内容进行交互。
• 需要对 Notion 内容进行搜索和读取操作。

注意事项

在使用 Notion MCP Server 时，需注意以下事项：

• 确保 API 密钥的安全性，避免泄露。
• 建议创建只读集成，以限制 AI 的操作权限。
• 确保目标页面已连接到集成，否则 AI 无法访问。
• Notion API 的功能有限，部分操作可能不被支持。

Notion MCP Server 通过标准化的 MCP 协议，为 AI 助手提供了与 Notion 内容交互的能力，使用户能够更高效地管理和操作 Notion 内容。