# Gemini Pro MCP

> Gemini Pro MCP is a free MCP server for ai models and llm tooling. Use your Google AI Pro plan from Claude, Codex and Gemini CLI through MCP tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/muzaqil555/gemini-pro-mcp
- **MCP Registry name:** io.github.Muzaqil555/gemini-pro-mcp
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

Rather than a paid Gemini API key, the Gemini tools here run through the Antigravity CLI signed in to your Google AI Pro or Ultra account, so they draw on the plan's own limits. A single setup command detects Claude Code, Codex, the Antigravity CLI and the Gemini CLI and adds the server to each, and a doctor command reports what works and how to fix what does not.

The tool set is grouped by what it runs on. Gemini and Deep Research calls use the subscription, Jules tools use an optional Jules API key, and image and video tools use the Gemini API, which is billed per use. Experimental browser tools drive your own signed-in Chrome to reach Google Flow, Gemini Notebooks and AI Mode; they are off until you enable them, and the README says the server never sees your Google password.

Defaults lean cautious: Gemini reads in a sandbox and cannot change files unless you call the code tool, and paid calls ask first unless you pre-approve spending.

## Features

- **Gemini on your plan:** Ask, research and code tools run through the Antigravity CLI instead of a pay-per-token key.
- **Jules coding agent:** Start sessions, approve plans and message Jules with a Jules API key.
- **Media generation:** Video and image tools use the Gemini API and are billed per use.
- **Flow and Notebooks:** Optional browser tools reach Google Flow and Gemini Notebooks.
- **One-command setup:** A setup command configures each detected client and doctor checks the result.

## Good for

- Get a second opinion from Gemini on a source file
- Run sourced research from inside a coding agent
- Generate a short video with Flow credits
- Turn PDFs into a Gemini Notebook Audio Overview
- Delegate a repository task to Jules

## Install

### Claude Code (Terminal)

```sh
claude mcp add gemini-pro-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env JULES_API_KEY='<JULES_API_KEY>' -- uvx gemini-pro-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gemini-pro-mcp": {
      "command": "uvx",
      "args": [
        "gemini-pro-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "JULES_API_KEY": "<JULES_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gemini-pro-mcp": {
      "command": "uvx",
      "args": [
        "gemini-pro-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "JULES_API_KEY": "<JULES_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gemini-pro-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gemini-pro-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "JULES_API_KEY": "<JULES_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gemini-pro-mcp": {
      "command": "uvx",
      "args": [
        "gemini-pro-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "JULES_API_KEY": "<JULES_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gemini-pro-mcp": {
      "command": "uvx",
      "args": [
        "gemini-pro-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<GEMINI_API_KEY>",
        "JULES_API_KEY": "<JULES_API_KEY>"
      }
    }
  }
}
```

## Tools

- `gemini_ask`
- `gemini_research`
- `gemini_code`
- `gemini_agents`
- `gemini_models`
- `jules_start`
- `jules_status`
- `jules_approve_plan`
- `jules_message`
- `jules_sources`
- `jules_sessions`
- `video_generate`
- `video_edit`
- `video_check`
- `image_generate`
- `video_stitch`
- `gemini_app`
- `gemini_app_result`
- `google_ai_mode`
- `google_page`
- `google_act`
- `google_pro_benefits`
- `flow_make_video`
- `flow_job`
- `flow_generate`
- `flow_approve`
- `flow_reject`
- `flow_collect`
- `flow_status`
- `flow_tools`
- `flow_open_tool`

## FAQ

### Do I need a Gemini API key?

Only for the image and video tools. The Gemini tools use your AI Pro plan through the Antigravity CLI.

### How do I install it?

Run uvx gemini-pro-mcp setup.

### Are the browser tools on by default?

No, they are off until you enable the browser option.

### Does it spend money without asking?

Paid calls ask first unless you use the auto-approve option.

### How many tools are there?

Up to 36, according to the README.

### Is Gemini Pro MCP free?

Yes. Gemini Pro MCP is free to use.

### How do I add Gemini Pro MCP to Claude Code?

Run this command in your terminal: claude mcp add gemini-pro-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env JULES_API_KEY='<JULES_API_KEY>' -- uvx gemini-pro-mcp

### What are the best alternatives to Gemini Pro MCP?

The closest alternatives to Gemini Pro MCP are headroom, omniget, next-ai-draw-io, mcp-for-blender and Claude Code Ultimate Guide.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [headroom](https://ai-powered.com/mcp/headroom-3): headroom is an open-source MCP server for ai models and llm tooling.
- [omniget](https://ai-powered.com/mcp/omniget): omniget is an open-source MCP server for ai models and llm tooling.
- [next-ai-draw-io](https://ai-powered.com/mcp/next-ai-draw-io-2): next-ai-draw-io is an open-source MCP server for ai models and llm tooling.
- [mcp-for-blender](https://ai-powered.com/mcp/mcp-for-blender): mcp-for-blender is an open-source MCP server for design and media.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [unity-mcp](https://ai-powered.com/mcp/unity-mcp-2): unity-mcp is an open-source MCP server for ai models and llm tooling.
- [fastapi_mcp](https://ai-powered.com/mcp/fastapi-mcp): fastapi_mcp is an open-source MCP server for ai models and llm tooling.
- [tyk](https://ai-powered.com/mcp/tyk): tyk is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/gemini-pro-mcp
