Skip to main content
Glama

GeminiMCP (v0.5.1)

Credits: Fikus & Hydrogen

A minimal, one-click Windows launcher that starts a local MCP (Model Context Protocol) file server + ngrok HTTPS tunnel, copies the MCP URL to your clipboard, and opens Gemini Web (gemini.google.com) so web models like Hydrogen and Argon can read, search, create, edit files, and inspect images on your PC.


Features

  • Zero-config launch — starts the MCP server, brings up ngrok, copies https://.../mcp to clipboard, and opens gemini.google.com automatically.

  • Auto-setup ngrok wizard — downloads ngrok.exe on first run, opens your browser to the token page, and saves your token.

  • Built-in Auto-Update — checks GitHub Releases on startup and updates gemini-mcp.exe in place.

  • Live activity log — shows every file read/write/edit call from Gemini in real time.

  • Live folder switching (/folder <path>) — switch your workspace folder anytime without reconnecting the MCP URL in Gemini.


Related MCP server: bridge-mcp

Quick Start

  1. Download gemini-mcp.exe from Releases.

  2. Double-click gemini-mcp.exe (or pass a folder path: gemini-mcp.exe "C:\Projects\MyApp").

  3. On first launch, sign in to ngrok when the browser opens and paste your free authtoken.

  4. It will copy https://xxxx.ngrok-free.dev/mcp to your clipboard and open gemini.google.com:

    • Go to Menu → Settings → Connected Apps → +

    • Paste the URL (leave OAuth Client ID & Secret blank) → Next → Connect.

    • Mention @Local PC Files GeminiMCP in any chat!

Optional Flags

gemini-mcp.exe [path] [--port 8000] [--token NGROK_TOKEN] [--allow-exec] [--no-tunnel] [--no-open] [--no-update-check]

Building from Source

cd source
python -m venv .venv
.\.venv\Scripts\pip install -r requirements.txt pyinstaller
.\.venv\Scripts\pyinstaller --noconfirm --onefile --console --name gemini-mcp `
  --hidden-import uvicorn.logging `
  --hidden-import uvicorn.loops.auto `
  --hidden-import uvicorn.protocols.http.auto `
  --hidden-import uvicorn.lifespan.on `
  gemini_mcp_cli.py

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers