Google Keep のMCPサーバー

貢献ガイドラインおよび必要な視覚的証拠については、貢献ガイドライン CONTRIBUTING.md を参照してください。

使い方

1. MCPサーバーをMCPサーバーに追加する:

またはuvxの場合:

2. 資格情報の追加:

• GOOGLE_EMAIL: あなたのGoogleアカウントのメールアドレス
• GOOGLE_MASTER_TOKEN:あなたのGoogleアカウントマスタートークン

Googleマスタートークンを入手

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