MCP-сервер для Google Keep

См. CONTRIBUTING.md для рекомендаций по вкладу и обязательных визуальных доказательств.

Как использовать

1. Добавьте MCP-сервер к вашим MCP-серверам:

Или с uvx:

2. Добавьте свои удостоверения:

• GOOGLE_EMAIL: Адрес электронной почты вашего аккаунта Google
• GOOGLE_MASTER_TOKEN: Ваш мастер-токен аккаунта Google

Получите мастер-токен Google

keep-mcp использует gkeepapi, который подключается к Google Keep через неофициальный приватный API. Мастер-токен Google имеет полный доступ к вашему аккаунту. Относитесь к нему как к паролю и никогда не коммитируйте и не делитесь им.

Используйте обмен токенами с поддержкой браузера, задокументированный gpsoauth. Выберите способ запуска биржи:

• Локальный Python: Следуйте альтернативному потоку gpsoauth.
• Docker: Следуйте инструкциям gkeepapi «Получение мастер-токена». Это запускает тот же обмен без необходимости локальной установки Python.

Оба варианта требуют браузера oauth_token, описанного в документации gpsoauth.

Старые инструкции могут запрашивать ваш пароль 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