Keep MCP

🚀 keep-mcp

Google のクラウドノート（Google Keep）の MCP サーバーです。

🚀 クイックスタート

使い方

1. MCP サーバーをあなたの MCP サーバーリストに追加します。

  "mcpServers": {
    "keep-mcp-pipx": {
      "command": "pipx",
      "args": [
        "run",
        "keep-mcp"
      ],
      "env": {
        "GOOGLE_EMAIL": "Your Google Email", // あなたのGoogleメールアドレス
        "GOOGLE_MASTER_TOKEN": "Your Google Master Token - see README.md" // あなたのGoogleマスタートークン（README.mdを参照）
      }
    }
  }

2. 認証情報を追加します。

• GOOGLE_EMAIL：あなたの Google アカウントのメールアドレス
• GOOGLE_MASTER_TOKEN：あなたの Google アカウントのマスタートークン（詳細は 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 を確認し、「モバイルデバイス管理を無効にする（管理なし）」を有効にしてください。