mcp-gee-sweet

mcp-gee-sweet を使うと、AI クライアントから Google Sheets、Docs、Drive、Calendar、Gmail に深く直接アクセスできます。=VLOOKUP() などの数式をそのまま読み取り、Docs を構造的に構築できます（colspan/rowspan テーブル、テーマ、名前付きスタイル、HTML/Markdown→AST→Docs のパイプライン）。さらに、Drive のファイル、共有、同期に加え、Calendar の予定や Gmail のメッセージ、スレッド、下書きにも対応しています。

主な特長：

• キャッシュ — 読み取りを繰り返す場合、毎回 API を呼び出す代わりにローカルキャッシュから約 2ms で結果を返します。
• 数式へのアクセス — 数式が返す値だけでなく、=VLOOKUP()、=SUM()、=IF() の式そのものを読み取ります。
• ローカル同期 — ローカルフォルダーと Google Drive の双方向同期に対応しています。

インストール（安定版）：

uvx mcp-gee-sweet

インストール（最新開発版 — develop のすべてのコード変更を反映）：

uvx --prerelease=allow mcp-gee-sweet

ドキュメント全文 →

---

対応サービス

サービス	ツール	特長
Google Sheets	36	数式へのアクセス、一括読み取り／書き込み、8 種類のグラフ、構造操作
Google Drive	38	ファイル操作、共有／権限、ローカル同期、変更履歴
Google Docs	34	完全な HTML→Doc パイプライン、テーブル、範囲のスタイル設定、テーマ、Markdown エクスポート
Google Calendar	17	予定の CRUD、複数のカレンダーを対象にした空き時間検索
Gmail	15	メッセージとスレッドの検索・読み取り、送信と返信、送信前に確認、編集、破棄できる下書き、ラベル（OAuth のみ）。デフォルトでは、ユーザーが確認するまで何も送信されません。確認を求められないクライアントでは、メールは下書きのまま残ります。Gmail の送信 を参照してください。

---

クイックスタート

オプション A：uv — ローカルでの使用と開発

リポジトリをクローンした場合や、自分のマシンでサーバーを使いたい場合は、uv だけで利用できます。Docker は不要です。

git clone https://github.com/khuisman/mcp-gee-sweet.git
cd mcp-gee-sweet
uv sync

以下の stdio トランスポートを使って MCP クライアントから接続してください（下記の MCP クライアントの設定 を参照）。クライアントは必要に応じてサブプロセスとしてサーバーを起動します。各セッションはそれぞれ独立したプロセスを使うため、コード変更や設定更新のためにサーバーを再起動しても、ほかの開いているセッションには影響しません。

オプション B：Docker — 複数クライアントで共有する常駐サーバー（SSE）

SSE 経由で複数のクライアントが接続する単一の長時間稼働サーバーを使いたい場合は、Docker を使用してください。たとえば、Claude Desktop と Claude Code が同じインスタンスに接続する場合です。

git clone https://github.com/khuisman/mcp-gee-sweet.git
cd mcp-gee-sweet
echo "MCP_SERVER_TOKEN=$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')" >> .env
make build   # build the container image
make start   # start the server (SSE on port 47000)
make logs    # tail logs

MCP クライアントから http://localhost:47000/sse に接続し、.env のトークンを Authorization: Bearer <token> ヘッダーに含めてください（下記の SSE 設定を参照）。トークンのないリクエストはサーバーによって拒否されます。Docker を使わない場合、--transport sse と --transport streamable-http は 127.0.0.1 のみで待ち受けます。ほかのアドレスで待ち受けるには MCP_SERVER_TOKEN が必要です。HTTP トランスポート認証 を参照してください。

注： SSE を使う場合、すべてのクライアントが 1 つのサーバープロセスを共有します。コード変更後または再起動後（make restart）は、再接続するために各 MCP クライアントも再起動する必要があります。

---

設定

デフォルトでは、サーバーは認証方法を順番に試します。最初は OAuth です。OAuth では、ユーザー本人として認証され、個人の Drive に完全にアクセスできます。これはローカル／開発環境で必要となる設定（上記のオプション A）です。OAuth を使うには、GCP Console から OAuth Client ID JSON をダウンロードし、サーバーにそのファイルを指定します。

export CREDENTIALS_PATH="/path/to/credentials.json"
export TOKEN_PATH="/path/to/token.json"
mcp-gee-sweet auth   # one-time browser login; `uvx mcp-gee-sweet auth` for a PyPI install

同じ CREDENTIALS_PATH と TOKEN_PATH を MCP クライアントの env に渡してください。トークンのない stdio サーバーは、自らブラウザーを開きません。代わりに、最初のツール呼び出しで Google の同意リンクが表示されます（または mcp-gee-sweet auth を実行します）。その後、呼び出しを再試行してください。セッション中にトークンが取り消された場合も、再起動せずに同様に処理されます。

サービスアカウント（ヘッドレスサーバーへのデプロイに推奨。上記のオプション B を参照）、base64 による認証情報の注入、Application Default Credentials にも対応しています。Gmail ツールには OAuth が必要です。すべてのオプションについては、認証を参照してください。

---

MCP クライアントの設定

Claude Desktop — ワンクリックバンドル： 最新の GitHub Release から mcp-gee-sweet-<version>.mcpb をダウンロードし、Claude Desktop で開きます。OAuth クライアントファイルの指定を求められますが、設定の編集は不要です（詳細）。

Claude Desktop — stdio（クローンしたリポジトリ）：

{
  "mcpServers": {
    "mcp-gee-sweet": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-gee-sweet", "mcp-gee-sweet"],
      "env": {
        "CREDENTIALS_PATH": "/path/to/credentials.json",
        "TOKEN_PATH": "/path/to/token.json"
      }
    }
  }
}

Claude Desktop — SSE（Docker）：

{
  "mcpServers": {
    "mcp-gee-sweet": {
      "transport": "sse",
      "url": "http://localhost:47000/sse",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

ツールのフィルタリングなど、その他のオプションについてはクライアントの設定を参照してください。

ツール数に上限のあるクライアントを使う

一部の MCP クライアントには、受け入れ可能なツール数の上限があります。このサーバーではすべてのツールが登録されるため、いずれの上限も超えてしまいます。

クライアント	上限
VS Code + GitHub Copilot（エージェントモード）	リクエストごとに128ツール（組み込みツールを含む）。上限を超えると、すべてのリクエストが「リクエストごとに128を超えるツールは指定できません」というエラーで失敗します
Windsurf	全サーバーを通じて合計100ツール
Cursor	モデルによって異なります（「このモードでは有効な MCP ツールが多すぎます」）
Google Antigravity	サーバーごとに100ツール（ユーザー報告）

これらのクライアントでは、サーバーの env で ENABLED_TOOLS を、100ツール未満の推奨サブセットのいずれかに設定してください。たとえば、Docs のツールすべて、または Docs と Drive の組み合わせを選べます。ツール数に上限のあるクライアントには、VS Code、Cursor、Windsurf 用の、すぐに貼り付けられる設定があります。

---

ドキュメント

• ツール — ドメイン別にまとめた、ツールの完全なリファレンス
• 認証 — 4種類すべての認証方法
• 設定 — 環境変数、キャッシュ、ツールのフィルタリング
• クライアントの設定 — MCP クライアント設定の例
• 設計原則 — ツールの採用方針、複合ツールに関する判断
• ロードマップ — 予定されている機能と既知の不足点

---

貢献

セットアップ、QA ワークフロー、PR ガイドラインについては、CONTRIBUTING.mdを参照してください。PyPI で安定版をリリースする前に、署名済みの docs/qa/runs/vX.Y.Z.md の記録が必須です。QA ワークフローについては、docs/qa/README.mdを参照してください。

ライセンス

MIT — LICENSEを参照してください。

クレジット

• xing5/mcp-google-sheets — このプロジェクトのフォーク元
• FastMCP
• freema/mcp-gsheets および piotr-agier/google-drive-mcp — ロードマップの参考