Skip to main content

Connect MCPBundles on Gemini CLI

For how MCP works in Gemini CLI — config, transports, and remote URLs — read How to Connect MCP Servers to Gemini CLI.

This page covers connecting MCPBundles MCP servers only.

Requirements​

  • Gemini CLI installed
  • An MCP server enabled in your MCPBundles dashboard
  • Credentials connected for the providers on that MCP server

Register the MCP URL (~/.gemini/settings.json)​

Gemini CLI and Gemini Code share the same MCP config file. On your MCP server page:

  1. Open the server in the MCPBundles dashboard.
  2. Copy the MCP server URL from the orange-bordered setup card (when the server is enabled and has tools).
  3. Expand Setup instructions, open the Gemini Code tab, and copy the ~/.gemini/settings.json snippet — or use:
{
  "mcpServers": {
    "your-server-name": {
      "url": "https://mcp.mcpbundles.com/bundle/YOUR-SERVER-SLUG"
    }
  }
}

Transport is auto-detected (HTTP first, then SSE). Add "type": "http" to skip the probe (same note as the Gemini Code tab).

The Gemini CLI tab in Setup instructions covers in-session usage only (/mcp list and auth prompts) — it does not add a separate config file.

Usage in the CLI​

After the URL is in settings.json, start Gemini CLI and run:

# List available MCP servers
/mcp list

# When prompted, authenticate connected services