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 文件。