Google Keep 的 MCP 服务器

请参见 CONTRIBUTING.md，了解贡献指南和所需的视觉证据。

如何使用

1. 将MCP服务器添加到你的MCP服务器：

或者用uvx：

2. 添加您的资历：

• GOOGLE_EMAIL：您的谷歌账户邮箱地址
• GOOGLE_MASTER_TOKEN：您的谷歌账户主令牌

获取谷歌主令牌

keep-mcp 使用 gkeepapi，通过非官方的私有 API 连接到 Google Keep。Google 主令牌拥有对你账户的完全访问权限。把它当作密码对待，切勿提交或分享。

使用由gpsoauth文档的浏览器辅助令牌交换。选择你想如何运行交易所：

• 本地Python： 遵循gpsoauth的替代流程。
• Docker： 按照 gkeepapi 的“获取主令牌”指令操作。这能运行同一个交易所，无需本地安装 Python。

这两个选项都需要使用gpsoauth文档中描述的浏览器oauth_token。

旧的说明可能会要求输入你的 Google 密码或应用密码并拨打 perform_master_login()。该流程不可靠，可能会返回 BadAuthentication。请使用上面的浏览器辅助流程。

特色

keep-mcp

MCP server for Google Keep

See CONTRIBUTING.md for contribution guidelines and required visual evidence.

How to use

1. Add the MCP server to your MCP servers:

  "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"
      }
    }
  }

Or with uvx:

  "mcpServers": {
    "keep-mcp": {
      "command": "uvx",
      "args": [
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email",
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md"
      }
    }
  }

2. Add your credentials:

• GOOGLE_EMAIL: Your Google account email address
• GOOGLE_MASTER_TOKEN: Your Google account master token

Obtain a Google master token

keep-mcp uses gkeepapi, which connects to Google Keep through an unofficial private API. A Google master token has full access to your account. Treat it like a password and never commit or share it.

Use the browser-assisted token exchange documented by gpsoauth. Choose how you want to run the exchange:

• Local Python: Follow gpsoauth’s alternative flow.
• Docker: Follow gkeepapi’s “Obtaining a Master Token” instructions. This runs the same exchange without requiring a local Python installation.

Both options require the browser oauth_token described in the gpsoauth documentation.

Older instructions may ask for your Google password or an app password and call perform_master_login(). That flow is unreliable and can return BadAuthentication. Use the browser-assisted flow above instead.

Features

Query and read tools

• find: Search notes (case-insensitive by default) with optional filters for labels, colors, pinned, archived, trashed, creation/update date ranges (ISO 8601, UTC), and a result limit
• get_note: Get a single note by ID

Creation and update tools

• create_note: Create a new note with title and text (automatically adds keep-mcp label)
• create_list: Create a checklist note
• update_note: Update a note’s title and text
• add_list_item: Add an item to a checklist note
• update_list_item: Update checklist item text and checked state
• delete_list_item: Delete a checklist item

Note state tools

• set_note_color: Set a note color (valid values: DEFAULT, RED, ORANGE, YELLOW, GREEN, TEAL, BLUE, CERULEAN, PURPLE, PINK, BROWN, GRAY)
• pin_note: Pin or unpin a note
• archive_note: Archive or unarchive a note
• trash_note: Move a note to trash
• restore_note: Restore a trashed/deleted note