Skip to main content

Gemini Code Integration

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

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. 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?​