Gemini CLI

Gemini CLI

Set up the Mixedbread MCP server with the 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.

Locate the configuration file

Global scope: ~/.gemini/settings.json

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

Add a Mixedbread server entry

Add the following to your settings.json:

{
  "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.

List servers:
```
gemini mcp list
```
You should see Mixedbread in the output.
Test the connection with a simple command in chat:
```
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