Gemsuite

v1.0.0Coding Agentsstable

Professional Gemini API integration for Claude and all MCP-compatible hosts with intelligent model selection and advanced file handling | Smithery.ai verified

agentai-toolsapiclaude-desktopclaude-integration
Share:
29
Stars
0
Downloads
0
Weekly
0/5

What is Gemsuite?

Gemsuite is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to professional gemini api integration for claude and all mcp-compatible hosts with intelligent model selection and advanced file handling | smithery.ai verified

Professional Gemini API integration for Claude and all MCP-compatible hosts with intelligent model selection and advanced file handling | Smithery.ai verified

This server falls under the Coding Agents and Developer Tools categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Professional Gemini API integration for Claude and all MCP-c

Use Cases

Gemini API integration with model selection
Advanced file handling
PV-Bhat

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedApr 10, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx gemsuite

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Gemsuite

GemSuite MCP brings Google's Gemini API into any MCP-compatible AI host — including Claude Desktop, Cursor, and Replit — through four intelligently routed tools: gem_search for real-time web information, gem_reason for complex step-by-step analysis, gem_process for fast high-volume content processing, and gem_analyze for multimodal file and document understanding. The server automatically selects the best Gemini model for each task and handles file uploads with automatic MIME type detection, exponential backoff for rate limits, and batch processing. Developers use it to complement Claude with Gemini's strengths — especially Gemini's long context window and native search grounding — without maintaining a separate integration.

Prerequisites

  • Node.js 16 or higher
  • A Google Gemini API key from Google AI Studio (aistudio.google.com)
  • An MCP-compatible client such as Claude Desktop, Cursor, or Replit
  • npm or npx available in your PATH
1

Install via Smithery CLI (easiest)

The Smithery CLI installs and configures GemSuite automatically for your chosen client.

npx -y @smithery/cli@latest install @PV-Bhat/gemsuite-mcp --client claude
2

Alternative: clone and build from source

For manual control, clone the repository, install dependencies, and build the TypeScript source.

git clone https://github.com/PV-Bhat/gemsuite-mcp.git
cd gemsuite-mcp
npm install
npm run build
3

Obtain a Gemini API key

Go to Google AI Studio at aistudio.google.com, sign in, and create an API key. Copy the key — you'll need it in the next step.

4

Set the GEMINI_API_KEY environment variable

Export the key in your shell or create a .env file in the gemsuite-mcp directory.

export GEMINI_API_KEY=your_gemini_api_key_here
# or create .env
echo "GEMINI_API_KEY=your_gemini_api_key_here" > .env
5

Configure Claude Desktop manually

If not using Smithery, add GemSuite to your claude_desktop_config.json with the GEMINI_API_KEY in the env block.

{
  "mcpServers": {
    "gemsuite": {
      "command": "node",
      "args": ["/absolute/path/to/gemsuite-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_gemini_api_key_here"
      }
    }
  }
}

Gemsuite Examples

Client configuration

Claude Desktop configuration for GemSuite with the Gemini API key passed as an environment variable.

{
  "mcpServers": {
    "gemsuite": {
      "command": "node",
      "args": ["/home/user/gemsuite-mcp/dist/index.js"],
      "env": {
        "GEMINI_API_KEY": "your_gemini_api_key_here"
      }
    }
  }
}

Prompts to try

Prompts that leverage each of GemSuite's four specialised tools.

- "Use gem_search to find the latest news about Model Context Protocol developments."
- "Use gem_reason to solve this maths proof step by step: prove that the square root of 2 is irrational."
- "Use gem_process to summarise this 50-page PDF and extract the key action items."
- "Use gem_analyze to review this image of the architecture diagram and identify potential bottlenecks."
- "Use gem_search to check current Gemini model pricing and compare it to Claude pricing."

Troubleshooting Gemsuite

GEMINI_API_KEY is set but gem_search returns 'API key not valid' errors

API keys created in Google AI Studio are project-scoped. Ensure the key is from a project with the Generative Language API enabled. Check the Google Cloud Console under APIs & Services to confirm.

gem_analyze fails on large files with a timeout or size error

GemSuite uses exponential backoff for rate limits, but very large files may exceed Gemini's file size limits. Split large documents into chunks or use gem_process for text-only summarisation first.

Smithery install completes but the gemsuite tools don't appear in Claude

Fully restart Claude Desktop after any MCP configuration change. Also verify the Smithery install updated the correct config file path for your OS (~/Library/Application Support/Claude/claude_desktop_config.json on macOS).

Frequently Asked Questions about Gemsuite

What is Gemsuite?

Gemsuite is a Model Context Protocol (MCP) server that professional gemini api integration for claude and all mcp-compatible hosts with intelligent model selection and advanced file handling | smithery.ai verified It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Gemsuite?

Follow the installation instructions on the Gemsuite GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Gemsuite?

Gemsuite works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Gemsuite free to use?

Yes, Gemsuite is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "gemsuite": { "command": "npx", "args": ["-y", "gemsuite"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Gemsuite?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides