Notion MCP

🚀 與 Notion 集成的 MCP 服務器

本項目是一個簡單的 Model Context Protocol (MCP) 服務器，它集成了 Notion 的 API，藉助 Claude 來管理個人待辦事項列表，專為極簡主義待辦事項列表量身打造。

🚀 快速開始

先決條件

• Python 3.10 或更高版本
• Notion 賬戶
• Notion 的 API 密鑰
• 符合上述描述的 Notion 數據庫（或有意願根據自己的結構進行修改）

設置步驟

1. 克隆倉庫：

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

2. 設置 Python 環境：

python -m venv .venv
source .venv/bin/activate  # 在 Windows 中使用：.venv\Scripts\activate
pip install -e .

3. 創建 Notion 集成：

   • 前往 https://www.notion.so/my-integrations
   • 創建新的集成
   • 複製 API 密鑰

4. 與你的數據庫共享該集成：

   • 打開你的待辦事項數據庫
   • 點擊菜單中的 "..." → "添加連接"
   • 選擇你的集成

5. 創建 .env 文件：

NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here

6. 配置 Claude Desktop：

{
  "mcpServers": {
    "notion-todo": {
      "command": "/path/to/your/.venv/bin/python",
      "args": ["-m", "notion_mcp"],
      "cwd": "/path/to/notion-mcp"
    }
  }
}

運行服務器

服務器可以通過兩種方式運行：

1. 直接從命令行：

# 在項目目錄中，激活虛擬環境後
python -m notion_mcp

2. 自動通過 Claude Desktop（推薦）：

• 如果在 claude_desktop_config.json 中正確配置，服務器啟動時會自動運行
• 無需手動管理服務器
• 當 Claude 關閉時，服務器也會停止

注意：直接運行時，服務器不會顯示任何輸出，除非有錯誤 - 這是正常的，因為它正在等待 MCP 命令。

✨ 主要特性

• 添加新的待辦事項
• 查看所有待辦事項
• 查看今天的工作任務
• 標記任務為已完成

📦 安裝指南

按照上述快速開始中的設置步驟進行操作，即可完成項目的安裝。

💻 使用示例

基礎用法

通過 Claude 的基本命令：

• "顯示我的所有待辦事項"
• "今天有什麼在我的列表上？"
• "今天添加一個待辦事項：查看郵件"
• "添加一個任務：以後的：審查項目"

📚 詳細文檔

注意事項

這是一個專為特定用例設計的個人項目：我的簡單的 Notion 待辦事項列表，它只有三個屬性：

• 任務（標題）
• 時間（選擇器，僅有兩個選項："今天" 或 "以後"）
• 複選框（標記是否完成）

示例 Notion 數據庫

儘管你可以將此代碼作為起點用於自己的 Notion 集成，但你可能需要根據自己的數據庫結構和需求進行修改。

限制

• 只能與特定的 Notion 數據庫結構一起使用
• 不支持複雜的數據庫架構
• 僅限於 "今天" 或 "以後" 的任務安排
• 不支持其他屬性或自定義字段
• 基本錯誤處理
• 沒有高級功能，如重複任務、優先級或標籤

自定義

如果你想使用不同的數據庫結構，請修改 server.py 文件，特別是：

• create_todo() 函數以匹配你的數據庫屬性
• call_tool() 中的任務格式化，以處理你的數據結構
• list_tools() 中的輸入模式，如果你想要不同的選項

項目結構

notion_mcp/
├── pyproject.toml
├── README.md
├── .env                   # 不包含在倉庫中
└── src/
    └── notion_mcp/
        ├── __init__.py
        ├── __main__.py
        └── server.py      # 主實現文件

📄 許可證

[在這裡插入許可證信息，例如 MIT 許可證或其他適用的許可證]

貢獻者

[列出貢獻者的姓名或 GitHub 用戶名]

另一個注意事項

[如果有的話，添加其他需要注意的事項，如問題報告、支持等]

⚠️ 重要提示

這個項目是為特定需求設計的，如果你有其他需求，請根據你的具體情況進行調整。