Notion MCP

🚀 個人待辦事項列表的簡單 MCP 服務器（Notion 集成）

這是一個簡單的 Model Context Protocol (MCP) 服務器，它集成了 Notion API，可用於管理個人的待辦事項列表。

🚀 快速開始

演示

視覺指南

Notion MCP 查詢 1

Notion MCP 查詢 2

Notion MCP 查詢 3

✨ 主要特性

• 顯示任務：列出所有待辦事項。
• 添加任務：創建新的待辦事項。
• 更新任務狀態：標記任務為完成。

📦 安裝指南

先決條件

• Python 3.11 或更高版本
• Notion 賬戶及 API 訪問權限
• Notion 集成令牌
• 想要在其中管理待辦事項的 Notion 頁面
• Claude Desktop 客戶端

安裝步驟

通過 Smithery 安裝

使用 Smithery 自動安裝 Notion MCP：

npx -y @smithery/cli install @Badhansen/notion-mcp --client claude

手動安裝

1. 克隆倉庫：

git clone https://github.com/Badhansen/notion-mcp.git
cd notion-mcp

2. 設置 Python 環境：

uv venv
source .venv/bin/activate
uv pip install -e .

3. 創建 Notion 集成：
   • 訪問 https://www.notion.so/my-integrations
   • 創建新的集成
   • 複製 API 令牌
4. 將您的數據庫/頁面與集成共享：
   • 打開 Notion 工作區中的數據庫/表格或頁面
   • 點擊菜單中的 "..."
   • 轉到 "添加連接"
   • 選擇您的集成（搜索名稱）

配置

1. 創建 .env 文件：

cp .env.example .env

2. 在 .env 中配置 Notion 憑據：

NOTION_TOKEN=<你的 Notion API 令牌>
PAGE_ID=<你的 Notion 頁面 ID>
NOTION_VERSION="2022-06-28"
NOTION_BASE_URL="https://api.notion.com/v1"

3. 要與 Claude Desktop 配合使用，請調整您的 claude_desktop_config.json 文件。 前往 Claude Desktop -> 設置 -> 開發人員 -> 配置文件 並編輯：

{
  "mcpServers": {
    "notionMcp": {
      "url": "http://localhost:5000",
      "enabled": true
    }
  }
}

💻 使用示例

基礎用法

顯示所有任務

{
  "command": "listTasks"
}

添加新任務

{
  "command": "addTask",
  "task": "購買雜貨"
}

標記任務為完成

{
  "command": "completeTask",
  "taskId": "unique_task_id_123"
}

📚 詳細文檔

項目結構

notion-mcp/
├── server.py          # 主服務器文件
├── config.py         # 配置參數
├── routes/           # 路由定義
│   ├── tasks.py      # 待辦事項相關路由
├── utils/            # 輔助函數
│   ├── notion_utils.py  # Notion API 工具
└── README.md         # 項目文檔

貢獻指南

1. Fork 倉庫：在 GitHub 上 Fork 此項目。
2. 創建分支：為新功能或修復創建新分支。
3. 提交更改：提交您的修改並添加詳細說明。
4. Push 到遠程倉庫。
5. 打開 Pull Request：針對主分支提出合併請求。

📄 許可證

本項目採用 MIT 協議。