Keep MCP

🚀 keep-mcp

keep-mcp 是 Google 雲端筆記（Google Keep）的 MCP 服務器，它為用戶提供了便捷的筆記管理功能，可幫助用戶更高效地操作 Google Keep 筆記。

🚀 快速開始

配置 MCP 服務器

將 MCP 服務器添加到您的 MCP 服務器列表中，以下是具體的配置代碼：

  "mcpServers": {
    "keep-mcp-pipx": {
      "command": "pipx",
      "args": [
        "run",
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email", // 您的谷歌郵箱地址
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md" // 您的谷歌主令牌（請參見README.md）
      }
    }
  }

添加憑證

添加您的谷歌賬戶憑證，具體信息如下：

• GOOGLE_EMAIL：您的谷歌賬戶電子郵件地址
• GOOGLE_MASTER_TOKEN：您的谷歌賬戶主令牌（詳見README.md）

更多詳情請參考 https://gkeepapi.readthedocs.io/en/latest/#obtaining-a-master-token 和 https://github.com/simon-weber/gpsoauth?tab=readme-ov-file#alternative-flow

✨ 主要特性

• find：根據查詢字符串搜索筆記
• create_note：創建新的筆記（標題和內容）並自動添加 keep-mcp 標籤
• update_note：更新筆記的標題和內容
• delete_note：將筆記標記為刪除

默認情況下，所有破壞性操作和修改操作僅限於由 MCP 服務器創建的筆記（即帶有 keep-mcp 標籤的筆記）。若要繞過此限制，可設置 UNSAFE_MODE 為 true，示例如下：

"env": {
  ...
  "UNSAFE_MODE": "true"
}

📦 安裝指南

發佈新版本到 PyPI

若要發佈新版本到 PyPI，可按以下步驟操作：

1. 更新 pyproject.toml 中的版本號。
2. 構建包：

pipx run build

3. 上傳到 PyPI：

pipx run twine upload --repository pypi dist/*

🔧 技術細節

故障排除

若出現錯誤信息 "DeviceManagementRequiredOrSyncDisabled"，請檢查 https://admin.google.com/ac/devices/settings/general 並啟用 "關閉移動設備管理（未管理）"。