gemini-pro-mcp

English · Türkçe · Русский · Azərbaycanca

Your Google AI Pro subscription, inside Claude, Codex and the Gemini CLI. Gemini 4 Argon, Deep Research, Flow videos, Gemini Notebooks, Jules and the rest of the plan you already pay for, as up to 36 MCP tools. One command sets it up.

36 tools · no API bill for Gemini · one command for Claude Code, Codex, Antigravity and Gemini CLI

uvx --from git+https://github.com/Muzaqil555/gemini-pro-mcp gemini-pro-mcp setup

If it saves you an API bill or a tab switch, a ⭐ helps other AI Pro users find it.

Why use it

• No extra bill for Gemini. gemini_ask, gemini_research and gemini_code run on your AI Pro plan's limits through the Antigravity CLI, not on a pay-per-token API key.
• The whole plan, not just chat. The tools reach Deep Research, Flow (any-length videos and every Flow tool), Gemini Notebooks (Audio Overviews, quizzes, slides), AI Mode, Jules and the Gemini app. google_pro_benefits lists each benefit and the tool that reaches it.
• A second brain for your coding agent. Claude or Codex can ask Gemini for a review, a sourced web search or a delegated edit without leaving the session.
• Set up in one command, checked in one more. setup adds the server to every client it finds. doctor checks what works and tells you how to fix what does not.
• Safe by default. Gemini reads in a sandbox and cannot change files unless you call gemini_code. Paid calls ask you first. The browser tools are off until you turn them on, and the server never sees or types your Google password.

Ask your agent things like:

"Get a second opinion from Gemini on src/auth.py."
"Research what changed in Flutter 3.47, with sources."
"Make a 2 minute video of a fox's journey through a snowy forest with my Flow credits."
"Put these three PDFs in a Gemini Notebook and make an Audio Overview."
"Turn this logo sketch (./sketch.png) into a clean flat icon, 2K."

How it compares

Most Gemini MCP servers give your agent one thing: a chat with Gemini, or the Gemini API's media models. This one covers the whole AI Pro plan.

Based on each project's README in November 2026. Corrections are welcome in an issue.

[^cli]: Google retired the Gemini CLI for Google AI Pro and Ultra users on 2026-06-18 in favor of the Antigravity CLI. API-key and enterprise users can still use it.

One MCP server, five ways into Google's AI:

Quick start

1. Prerequisites

• uv (or Python 3.10+ with pip)
• For the Gemini tools: install the Antigravity CLI, run agy once and sign in with your Google AI Pro/Ultra account.
• For the media tools: an API key from Google AI Studio with billing enabled. See Costs.

2. Add it to your clients (one command)

uvx --from git+https://github.com/Muzaqil555/gemini-pro-mcp gemini-pro-mcp setup

setup finds Claude Code, Codex, the Antigravity CLI and the Gemini CLI on your computer, adds the server to each one, and then checks what works: the Antigravity sign-in, your API keys, Chrome and the Flow profile. Each item it reports as missing comes with the fix. Restart the clients afterwards.

• --browser also enables the Flow, Gemini app, AI Mode and Notebook tools. Run gemini-pro-mcp flow-login once afterwards and sign in to Google in the window that opens.
• --auto-approve pre-approves spending, so paid tools run without asking first.
• --client codex (repeatable) sets up only the clients you name. --dry-run shows the changes without making them.

Edited config files are backed up next to themselves (config.toml.bak, settings.json.bak). To check things again later, without changing anything:

uvx --from git+https://github.com/Muzaqil555/gemini-pro-mcp gemini-pro-mcp doctor --flow

To add the server by hand instead, use the client's own command:

Claude Code

claude mcp add gemini-pro --scope user -- uvx --from git+https://github.com/Muzaqil555/gemini-pro-mcp gemini-pro-mcp

Codex

codex mcp add gemini-pro -- uvx --from git+https://github.com/Muzaqil555/gemini-pro-mcp gemini-pro-mcp

Or in ~/.codex/config.toml. Raise the tool timeout: Flow and Deep Research calls take minutes, longer than Codex's default.

[mcp_servers.gemini-pro]
command = "uvx"
args = ["--from", "git+https://github.com/Muzaqil555/gemini-pro-mcp", "gemini-pro-mcp"]
startup_timeout_sec = 60
tool_timeout_sec = 900

Antigravity CLI and Gemini CLI

agy mcp add gemini-pro -- uvx --from git+https://github.com/Muzaqil555/gemini-pro-mcp gemini-pro-mcp
gemini mcp add gemini-pro uvx --from git+https://github.com/Muzaqil555/gemini-pro-mcp gemini-pro-mcp

Settings go in as environment variables, e.g. agy mcp add --env GEMINI_PRO_ENABLE_BROWSER=1 gemini-pro -- ..., or in the .env file below.

Claude Desktop, Cursor, Windsurf and other clients. Add this to the client's MCP config:

{
  "mcpServers": {
    "gemini-pro": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Muzaqil555/gemini-pro-mcp", "gemini-pro-mcp"]
    }
  }
}

3. Add your API key (media tools only)

Put it in ~/.config/gemini-pro-mcp/.env so it stays out of client configs:

GEMINI_API_KEY=your-key

Or pass it as an env entry in the client config. Restart the client afterwards.

Tools

Gemini on your subscription

Every request runs agy --print in plan mode with the sandbox on, so Gemini can read and search but cannot change your files or run commands.

Media through the Gemini API

Files are saved to ~/gemini-pro-output (change it with GEMINI_PRO_OUTPUT_DIR).

Video uses Gemini Omni Flash. Google shut down the Veo 3.1 preview models on 2026-10-22 and recommends Omni Flash instead.

Costs

Prices are taken from Google's pricing page as of October 2026. Check it for current numbers.

Does Google AI Pro pay for the API? Not directly. Google says plan benefits apply in the AI Studio web UI, and API-key usage is billed separately. AI Pro does include a monthly Google Cloud credit through the Google Developer Program, which can be spent on the Gemini API once billing is enabled. Google's blog gives the amount as $10/month.

By default the server tells the model to confirm with you before every paid call. If you would rather not be asked, set GEMINI_PRO_AUTO_APPROVE=1: the model then just does it and reports the cost afterwards.

Configuration

Everything in Google AI Pro

google_pro_benefits lists every benefit of the plan and the tool that reaches it. Here is the short version:

google_page and google_act work like a person in your browser. They read a page as numbered elements, then click, type, upload files, choose options and download results, so a new feature in any of these apps is usable on day one. They only operate the Google AI sites listed in google_web.py. Sign-in, payment and account pages are off limits.

Flow (experimental)

Google Flow has no public API. The Flow tools drive the website in a dedicated Chrome profile that you sign in to yourself:

uvx --from "gemini-pro-mcp[flow] @ git+https://github.com/Muzaqil555/gemini-pro-mcp" gemini-pro-mcp flow-login

Then set GEMINI_PRO_ENABLE_BROWSER=1 (the older GEMINI_PRO_ENABLE_FLOW=1 still works). This enables every browser-based tool: Flow, the Gemini app, AI Mode and the other Google AI sites, all in that one signed-in profile.

Every Flow feature is reachable. Flow's agent (flow_generate) handles anything you can ask in words, and google_page + google_act operate anything with buttons. For example, "put my last clip through Video Resizer at 9:16" opens the tool, imports the clip, exports a 9:16 copy and downloads it. That flow was tested end to end.

By default spending is a separate call: flow_generate stops at Flow's own permission question, and the model has to ask you before it calls flow_approve. With GEMINI_PRO_AUTO_APPROVE=1 the tools approve it themselves. Either way, keep Flow's "Confirm before generating: Always" setting on (the default), because the tools rely on that question.

Tested on 2026-10-21 with Omni 1.1 Flash: an 8 s, 1280×720, 24 fps video for 12 credits, end to end.

Read this first. Automating Flow's website may conflict with Google's terms of service, and it breaks whenever Google changes the page. This project never types or stores your credentials and uses no stealth tricks. If Google shows a CAPTCHA, you solve it. Use at your own risk.

How it works

Claude ── MCP (stdio) ──> gemini-pro-mcp ──┬── agy --print (plan + sandbox) ──> Gemini on your AI Pro plan
                                           ├── google-genai Interactions API ──> Omni Flash / Nano Banana
                                           └── Playwright over CDP ──> your Chrome ──> flow.google.com

Roadmap

• Flow: generate, approve and download videos with plan credits
• Flow: videos of any length (flow_make_video)
• Flow: images, characters, smoother shot transitions (extend instead of separate clips)
• Music generation (Lyria)
• Publish to PyPI (uvx gemini-pro-mcp)
• Deep Research reports
• Animated demo (docs/demo.svg, built by docs/make_demo.py from real output)
• One-command setup for Claude Code, Codex, Antigravity CLI and Gemini CLI

Ideas and pull requests are welcome. See CONTRIBUTING.md.

Disclaimer

This is an independent open-source project. It is not affiliated with, endorsed by or sponsored by Google or Anthropic. Gemini, Google AI Pro, Flow and Antigravity are trademarks of Google LLC.

License

MIT