gemini-web-mcp

Query Gemini Web (gemini.google.com) from Claude Code and other MCP clients.

Uses browser cookies instead of the official Gemini API, so an existing Google AI subscription's models and quota can be used. Built on HanaokaYuzu/Gemini-API.

• 会話は自分で決めた label で扱えます。conversation ID を持ち回る必要はありません

• 既定では Gemini Web の履歴に残りません。手元で使っている会話一覧が MCP の会話で埋まりません

• モデルを選べます (3.6 Flash / Pro など)。強化思考モードも指定できます

Tested on Linux and macOS. Windows は未対応 (パスは ~/.config/... 固定、fcntl に依存)。

セットアップ

新しいホストでゼロから始める場合、この順に進めてください。

1. インストール

uv tool install git+https://github.com/TakashiAihara/gemini-web-mcp

gemini-web-mcp が PATH に入ります。

curl -LsSf https://astral.sh/uv/install.sh | sh

2. cookie を入れる

Gemini Web は API キーではなくブラウザの cookie で認証します。取得方法は環境によって 2 通りあります。

2-a. ブラウザが同じホストにある場合

browser-cookie3 が Chrome / Firefox 等から自動抽出します。

uv tool install "git+https://github.com/TakashiAihara/gemini-web-mcp[browser]"
gemini-web-mcp login

2-b. ブラウザが別ホストにある場合

Claude Code をリモートの Linux で動かし、ブラウザは手元の PC という構成ではこちらです。MCP server は Claude Code と同じホストで動くため、リモート側にログイン済みブラウザが無く、自動抽出は使えません。

1. ブラウザで https://gemini.google.com を開く

2. DevTools → Application → Cookies → https://gemini.google.com

3. __Secure-1PSID と __Secure-1PSIDTS の値をコピー

4. すぐに 実行 (__Secure-1PSIDTS は短時間で失効します)

対話入力 (推奨) — 値がコマンドラインに乗らないので shell 履歴に残りません。

gemini-web-mcp login --interactive

__Secure-1PSID  :          # 入力は表示されません
__Secure-1PSIDTS: (空可)

GEMINI__SECURE_1PSID='...' GEMINI__SECURE_1PSIDTS='...' gemini-web-mcp login

この形は値が shell 履歴 (~/.zsh_history 等) に平文で残ります。 履歴に残したくない場合は上の対話入力を使うか、secret manager 経由で注入してください。

成功すると:

Login OK.
  cookie cache : ~/.config/gemini-web-mcp/cookies
  sessions     : ~/.config/gemini-web-mcp/sessions.json

一度成功すればキャッシュされ、以降は自動更新されます。 環境変数の再指定は不要で、次の手順で cookie を渡す必要もありません。

cookie は Google アカウントのセッションそのものです。チャットや issue に貼らないでください。

3. 動作確認

gemini-web-mcp doctor

認証・cookie・使えるモデル・保存済み session をまとめて確認します。問題があれば対処方法を表示します。

[OK  ] config dir       ~/.config/gemini-web-mcp (mode 0o700)
[OK  ] cookie cache     ~/.config/gemini-web-mcp/cookies (mode 0o700) / 1 件 / 最終更新 0.1 時間前
[OK  ] environment      上書きなし (既定値を使用)
[OK  ] sessions         ~/.config/gemini-web-mcp/sessions.json (未作成 — 会話を作ると生成されます)
[OK  ] authentication   account_status=1000
[OK  ] models           3 件: 3.5 Flash-Lite, 3.6 Flash, 3.1 Pro
[OK  ] default model    'Pro' -> 3.1 Pro

ネットワークに出さずローカルの設定だけ見る場合は --offline を付けます。

doctor は cookie の値を出力しませんが、絶対パス (ユーザー名を含む) と契約中のモデル一覧が出ます。公開 issue に貼る場合はその 2 点を伏せてください。

4. Claude Code に登録

claude mcp add gemini-web -- gemini-web-mcp serve

Claude Code を再起動し、/mcp で gemini-web が認識されていれば完了です。

claude mcp add gemini-web -- \
  uvx --from git+https://github.com/TakashiAihara/gemini-web-mcp gemini-web-mcp serve

この場合 gemini-web-mcp は PATH に入らないため、login / doctor も uvx --from ... 経由で叩く必要があります。

Related MCP server: MCP Server Gemini

使い方

label は [a-zA-Z0-9_\-]{1,64}。会話継続に必要な metadata は server が保持するので、呼び出し側は ID を覚える必要がありません。

手元の会話との分離

既定で temporary モード を使うため、MCP 経由の会話は Gemini Web のサイドバーに出ません。手元で使っている履歴に混ざらないようにするためです。

履歴に残したい場合は GEMINI_WEB_MCP_TEMPORARY=0 を設定します。

履歴に出ないにもかかわらず、label に紐づけた metadata を server が保持しているため 別プロセス・別セッションからでも会話を継続できます。

モデル

gemini_models_list() でアカウントに紐づくモデルを取得できます (実測例):

model には UI 表記 ("3.6 Flash") / display 名 ("Pro") / model_id のいずれでも渡せます。既定は "Pro"。版番号ではなく display 名を既定にしているのは、Google が Pro / Flash / Flash-Lite の区分を保ったまま版を上げる (3.1 Pro → 3.2 Pro) ためです。

gemini_chat_continue ではモデルを変更できません。Gemini が会話途中のモデル変更を拒否するためで、別モデルで訊きたい場合は gemini_chat_new で新しい label を作ってください。

強化思考モード

gemini_chat_new(thinking=True) で強化思考モード (UI 表記「Flash 拡張」等) を有効にできます。難問向けで、応答は遅くなりますが thoughts に思考過程が返ることがあります。会話ごとに固定され gemini_chat_continue にも引き継がれます。

なお thoughts は同一条件でも返ったり返らなかったりするため、強化思考が効いているかの判定には使えません。

設定

sessions.json は ~/.config/gemini-web-mcp/sessions.json。ディレクトリは 0700、ファイルは 0600 で作られます。

複数アカウントを併用する

GEMINI_COOKIE_PATH と XDG_CONFIG_HOME を分ければ、アカウントごとに MCP server を並立できます。

claude mcp add gemini-web-work \
  --env GEMINI_COOKIE_PATH=$HOME/.config/gemini-web-mcp-work/cookies \
  --env XDG_CONFIG_HOME=$HOME/.config/gemini-web-mcp-work-xdg \
  -- gemini-web-mcp serve

困ったとき

まず gemini-web-mcp doctor を実行してください。

開発

git clone https://github.com/TakashiAihara/gemini-web-mcp
cd gemini-web-mcp
uv sync --all-extras
uv run pytest -v

設計と、モデル選択・思考モードの解析経緯は docs/design.md にあります。

依存の pin について

gemini-webapi は PyPI 版ではなく git の特定 commit を pin しています。PyPI 最新リリース v2.0.0 は ChatSession が状態を全 session で共有するバグを含み、別の会話に前の会話の ID が漏れます。修正は commit にありますが、以降リリースが切られていません。解除条件は pyproject.toml の [tool.uv.sources] を参照してください。

License

AGPL-3.0-or-later. See LICENSE.

依存する gemini-webapi が AGPL-3.0 のため、本パッケージもそれに揃えています。