keep-mcp

🚀 keep-mcp

Google 云端笔记（Google Keep）的 MCP 服务器，可助力你更便捷地管理 Google Keep 笔记。

🚀 快速开始

如何使用

1. 添加 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）
      }
    }
  }

2. 添加凭证：
   • 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

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 并启用 "关闭移动设备管理（未管理）"。