Gemini CLI

Learn how to set up the Mixedbread MCP server with the Gemini CLI.

Prerequisites

Before we configure Gemini CLI, make sure you have the following:

• Gemini CLI installed
• Node.js 22+ installed
• A Mixedbread API key from our platform

Configuration

Gemini CLI configures MCP servers via a configuration file named settings.json.

1. Locate the configuration file

   Global scope: ~/.gemini/settings.json

   If this file doesn't exist yet, you can create it manually.

2. Add a Mixedbread server entry

   Add the following to your settings.json:

   Copy to clipboard

   {
     "mcpServers": {
       "mixedbread": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote@latest",
           "https://www.mcp.mixedbread.com/api/mcp",
           "--header",
           "Authorization:${MXBAI_AUTH_HEADER}"
         ],
         "env": {
           "MXBAI_AUTH_HEADER": "Bearer YOUR_MIXEDBREAD_API_KEY"
         },
         "trust": false,
         "timeout": 600000
       }
     }
   }

   • command tells Gemini to run mcp-remote via npx.
   • args specify the remote MCP endpoint and the header used for authentication.
   • env sets an environment variable that contains your API key.
   • trust controls whether tools require confirmation before execution.
   • timeout sets the request timeout in milliseconds. Defaults to 600000ms (10 minutes).

   Replace YOUR_MIXEDBREAD_API_KEY with your actual API key from the Mixedbread platform.

Verification

Now let's confirm the integration is working.

1. List servers:

   Copy to clipboard

   gemini mcp list

   You should see Mixedbread in the output.

2. Test the connection with a simple command in chat:

   Copy to clipboard

   Create a new store called "my-knowledge-base"

Now you can manage your Stores and perform Search directly from the Gemini CLI.

References

• Gemini CLI docs: MCP servers