MCP Directory

How to add GemSuite MCP to Windsurf

Comprehensive Gemini API integration for MCP hosts with intelligent model selection and file handling. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 29★ · stdio · apikey

Windsurf config for GemSuite MCP

npx -y @smithery/cli@latest install @PV-Bhat/gemsuite-mcp --client claude
{
  "mcpServers": {
    "gemsuite-mcp": {
      "command": "npm",
      "args": [
        "start"
      ],
      "env": {
        "GEMINI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the GemSuite MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5GemSuite MCP's tools become available to Cascade.

Before you start

  • Node.js 16+
  • A Google Gemini API key from Google AI Studio (set as GEMINI_API_KEY)

What GemSuite MCP can do in Windsurf

gem_search

Information retrieval with Gemini search integration (Gemini Flash). For factual questions, current information, and grounded responses; supports file inputs and optional thinking.

gem_reason

Complex reasoning with step-by-step analysis (Gemini Flash Thinking). For math, science, coding problems, and logical analysis; supports a file_path and show_steps option.

gem_process

Fast, token-efficient content processing (Gemini Flash-Lite). Supports operations: summarize, extract, restructure, simplify, expand, critique, feedback, and analyze.

gem_analyze

Intelligent file analysis with automatic model selection. For document analysis, code review, and image understanding via a file_path and instruction.

Security

Requires a Google Gemini API key (GEMINI_API_KEY), obtainable from Google AI Studio. Store it in a .env file or as an environment variable; do not commit it. File-handling tools accept local file paths, so the server has access to files you reference.

GemSuite MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the GemSuite MCP config there under the "mcpServers" key and restart the client.

Is GemSuite MCP safe to use with Windsurf?

Requires a Google Gemini API key (GEMINI_API_KEY), obtainable from Google AI Studio. Store it in a .env file or as an environment variable; do not commit it. File-handling tools accept local file paths, so the server has access to files you reference.

How do I install GemSuite MCP?

Recommended: run `npx -y @smithery/cli@latest install @PV-Bhat/gemsuite-mcp --client claude`. Alternatively, clone the repo, run `npm install`, set GEMINI_API_KEY in a .env file, run `npm run build`, then `npm start`.

Which Gemini models does it use?

It uses Gemini 2.0 Flash (search, multimodal), Gemini 2.0 Flash-Lite (fast, cost-efficient processing), and Gemini 2.0 Flash Thinking (reasoning), selecting automatically per task. You can override with the model_id parameter.

Do I need an API key?

Yes. Obtain a Gemini API key from Google AI Studio and set it as the GEMINI_API_KEY environment variable or in a .env file.

View repo Full GemSuite MCP page