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