Skip to main content

Gemini Code MCP Setup

Connect your MCP bundles to Gemini Code to give Google's AI coding assistant access to external tools.

Requirements​

  • Gemini Code editor (latest version)
  • A bundle enabled in your MCPBundles dashboard
  • Credentials connected for providers in your bundle

Time to complete: 2-3 minutes

If you have terminal access, the fastest way to connect is via the MCPBundles CLI:

pip install mcpbundles
mcpbundles init

This automatically discovers your bundles, writes the Gemini Code config, and handles authentication. No manual JSON editing needed.

After running mcpbundles init, restart Gemini Code and your tools will be available.

Want more control? Use mcpbundles tools to browse available tools, or mcpbundles call <tool-name> to test a tool directly from your terminal.

Option B: Manual Setup​

Step-by-Step Setup​

1. Get Your Bundle URL​

  1. Log in to MCPBundles Dashboard
  2. Click on the bundle you want to use
  3. Scroll to the "Quick Setup" section (only visible when bundle is operational)
  4. Copy the MCP Server URL

2. Locate Gemini Config File​

Gemini Code uses ~/.gemini/settings.json for MCP configuration.

File location:

  • macOS/Linux: ~/.gemini/settings.json
  • Windows: %USERPROFILE%\.gemini\settings.json

If the file or directory doesn't exist, create it:

mkdir -p ~/.gemini
touch ~/.gemini/settings.json

3. Add Bundle Configuration​

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "your-bundle-name": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mcpbundles.com/bundle/YOUR-BUNDLE-ID"]
    }
  }
}

Replace:

  • your-bundle-name - Short identifier (e.g., marketing)
  • https://mcp.mcpbundles.com/bundle/YOUR-BUNDLE-ID - Your actual bundle URL

Example with multiple bundles:

{
  "mcpServers": {
    "marketing": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mcpbundles.com/bundle/abc123"]
    },
    "dev-tools": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mcpbundles.com/bundle/def456"]
    }
  }
}

4. Restart Gemini Code​

  1. Quit Gemini Code completely
  2. Reopen it
  3. Wait 10-20 seconds for MCP to initialize

Note: On first launch, npx will download mcp-remote package. This may take a minute.

5. Verify Connection​

Ask the AI assistant: "What tools do you have access to?"

Expected response: List of tools from your bundle(s).

Using Tools in Gemini Code​

Once connected, Gemini can use your tools for coding tasks.

Example Prompts​

Data-driven development:

"Fetch the latest Smartlead campaigns and create a TypeScript interface matching the schema"

GitHub operations:

"List my GitHub repos and generate a script to clone all of them"

Integration code:

"Get the latest HubSpot contacts and write a Python script to export them to CSV"

Gemini will call tools, get real data, and generate code.

Troubleshooting​

"mcp-remote not found"​

Cause: npx hasn't downloaded the package yet.

Fix:

  • Wait 30-60 seconds on first launch
  • Or manually install: npm install -g mcp-remote
  • Restart Gemini Code

"MCP server connection failed"​

Fix:

  • Check URL is correct (including https://)
  • Verify bundle is enabled in dashboard
  • Make sure command is "npx" and args is an array
  • Restart Gemini Code

Tools don't appear after adding config​

Fix:

  1. Quit Gemini Code completely
  2. Wait 5 seconds
  3. Reopen
  4. Wait 30 seconds (longer first time for package download)

"Authentication required" when calling tools​

Fix:

  1. Go to Dashboard → Providers
  2. Connect credentials for needed providers
  3. Try the tool again in Gemini Code

See Provider Credentials Guide.

JSON syntax error in settings.json​

Common mistakes:

Missing comma:

{
  "mcpServers": {
    "bundle1": { "command": "npx", "args": [...] }  // ❌ Missing comma
    "bundle2": { "command": "npx", "args": [...] }
  }
}

Should be:

{
  "mcpServers": {
    "bundle1": { "command": "npx", "args": [...] },  // ✅ Has comma
    "bundle2": { "command": "npx", "args": [...] }
  }
}

Fix: Use a JSON validator to check syntax.

Configuration Details​

Required Fields​

FieldValueNotes
command"npx"Package runner
args["mcp-remote", "YOUR-URL"]Array with package name and URL

Important:

  • args must be an array
  • URL goes in the array, not as a separate field
  • mcp-remote package acts as an HTTP-to-stdio bridge

Advanced Configuration​

Multiple Bundles​

{
  "mcpServers": {
    "marketing": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mcpbundles.com/bundle/abc123"]
    },
    "dev": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mcpbundles.com/bundle/def456"]
    },
    "crm": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mcpbundles.com/bundle/ghi789"]
    }
  }
}

With Other MCP Servers​

{
  "mcpServers": {
    "mcpbundles-marketing": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.mcpbundles.com/bundle/abc123"]
    },
    "local-filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"]
    }
  }
}

Next Steps​

Need Help?​