gemini-web-mcp
This server enables interaction with Gemini Web (gemini.google.com) via MCP using browser cookies and a Google AI subscription (no API key required). Conversations are saved locally by default, not to the official Gemini history (configurable). You can:
Start a new conversation (
gemini_chat_new): Provide a prompt and a human-friendly label; optionally specify a model (e.g., "Pro", "3.6 Flash") and enable enhanced thinking mode (thinking=true) which persists throughout the conversation.Continue a conversation (
gemini_chat_continue): Resume a labeled conversation with a new prompt, automatically inheriting the original model.List saved conversations (
gemini_chat_list): View all locally stored conversations with their label, model, turn count, thinking mode status, and last-used timestamp.Retrieve conversation history (
gemini_chat_history): Get the full message history (role, text, timestamp) for a specific conversation by label.Delete a conversation (
gemini_chat_delete): Remove a saved conversation from local storage using its label.List available models (
gemini_models_list): Fetch the models available to your Google account (e.g., Flash-Lite, Flash, Pro) with their names and descriptions.
Provides tools for interacting with Google's Gemini Web chat service, enabling creation and continuation of conversations, managing chat sessions, and listing available models.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gemini-web-mcp Start a new chat and ask Gemini to explain the difference between AI and ML"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpgemini-web-mcp が PATH に入ります。
curl -LsSf https://astral.sh/uv/install.sh | sh2. 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 login2-b. ブラウザが別ホストにある場合
Claude Code をリモートの Linux で動かし、ブラウザは手元の PC という構成ではこちらです。MCP server は Claude Code と同じホストで動くため、リモート側にログイン済みブラウザが無く、自動抽出は使えません。
ブラウザで https://gemini.google.com を開く
DevTools → Application → Cookies →
https://gemini.google.com__Secure-1PSIDと__Secure-1PSIDTSの値をコピーすぐに 実行 (
__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 serveClaude 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: gemini-skill
使い方
tool | 用途 |
| 新規会話を開始し、 |
| 既存の会話を再開して続きを訊く |
| 保存中の会話一覧 |
| 指定した会話の履歴を全件返す |
| 指定した会話をローカルから削除 |
| このアカウントで使えるモデル一覧 |
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() でアカウントに紐づくモデルを取得できます (実測例):
name | display | 説明 |
| Flash-Lite | すばやく回答を得るのに最適 |
| Flash | あらゆる場面でサポート |
| Pro | 高度な数学とコーディングに最適 |
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 は同一条件でも返ったり返らなかったりするため、強化思考が効いているかの判定には使えません。
設定
env | 既定値 | 用途 |
|
|
|
|
|
|
|
| cookie キャッシュの場所 |
| (空) | cookie を直接渡す (初回のみ) |
| (空) | 同上 |
| (空 = | 設定ディレクトリの基点 |
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 を実行してください。
症状 | 対処 |
| cookie の期限切れです。 |
|
|
|
|
| Google AI 側の使用量上限です。リセットまで待つ必要があります |
Claude Code が tool を認識しない | Claude Code を再起動し、 |
開発
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 のため、本パッケージもそれに揃えています。
Available Tools
6 toolsgemini_chat_continueA
既存 conversation に prompt を投げ、応答を返す。
モデルは会話開始時のものを引き継ぐ。Gemini は会話途中のモデル変更を
ModelInvalid (error code 1050 = model inconsistent with history) で
拒否するため、途中変更は受け付けない。別モデルで訊きたい場合は
gemini_chat_new で新しい label を作る。
Inputs: label (required), prompt (required). Returns: text, label, metadata, thinking, +1 more
gemini_chat_deleteB
指定 session を local から削除する。
Inputs: label (required). Returns: deleted
gemini_chat_historyA
指定 session の会話履歴を全件返す。
Inputs: label (required). Returns: label, model, turns
gemini_chat_listB
保存中の conversation 一覧。
Inputs: no named parameters. Returns: result
gemini_chat_newB
新規 conversation を作って prompt を投げ、応答を返す。
Inputs: label (required), prompt (required), model, thinking. Returns: text, label, metadata, thinking, +1 more
gemini_models_listA
このアカウントで実際に使えるモデルの一覧。
name をそのまま gemini_chat_new(model=...) に渡せる。
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: starting a new conversation, continuing an existing one, listing models, listing conversations, viewing history, and deleting. The overlap between new and continue is resolved by explicit descriptions of creating vs. continuing.
All tools share the gemini_ prefix and mostly follow a resource_verb pattern (chat_new, chat_continue, chat_list, chat_delete, models_list). The exception is gemini_chat_history, where 'history' is a noun rather than a verb, creating a minor inconsistency.
With 6 tools, the server is well-scoped for chat conversation management. Each tool serves a distinct function in the lifecycle (create, continue, list, read history, delete) plus model discovery, without unnecessary bloat.
The tool set covers the complete workflow: create a conversation, continue it, list all conversations, retrieve full history, and delete. Model listing supports selecting the right model upfront. No obvious gaps remain for the stated purpose of interacting with Gemini conversations.
Maintenance
Related MCP Connectors
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for AI dialogue using various LLM models via AceDataCloud
Related MCP Servers
- AlicenseAqualityDmaintenanceModel Context Protocol (MCP) server implementation that enables Claude Desktop to interact with Google's Gemini AI models.675 npm260MIT
- AlicenseNot gradedqualityCmaintenanceMCP server to control Gemini web interface via CDP for AI image generation, chat, and image extraction.833MIT
- AlicenseAqualityCmaintenanceMCP server for Google Gemini that enables image generation, editing, file analysis, and chat using browser cookies, no API key needed.666AGPL 3.0
- AlicenseNot gradedqualityDmaintenanceMCP server for Google's Gemini CLI with OAuth, enabling use of Gemini through Claude Desktop/Code without API keys – just log in with a Google account.1MIT