---
title: "Gemini CLI"
slug: "gemini-cli"
updated: 2026-07-11T19:43:46Z
published: 2026-07-11T19:43:46Z
canonical: "docs.dataddo.com/gemini-cli"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dataddo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gemini CLI

> 🚧 **Prototype**
> 
> 
> The Dataddo MCP server is an early prototype. See the [Dataddo MCP Server overview](/docs/dataddo-mcp-server) for its current capabilities and roadmap.

Connect the [Dataddo MCP server](/docs/dataddo-mcp-server) to [Gemini CLI](https://github.com/google-gemini/gemini-cli), Google's open-source AI agent for the terminal. Gemini CLI supports remote Streamable HTTP servers with custom headers.

## Prerequisites

- A Dataddo API access token. See [Headless API Authorization](/headless/docs/dataddo-api-authorization).
- Gemini CLI installed.

## Setup

1. Open your Gemini settings file:
  - **All projects:** `~/.gemini/settings.json`
  - **Single project:** `.gemini/settings.json` in the project root
2. Add the Dataddo server under `mcpServers`. Note that remote Streamable HTTP servers use the `httpUrl` key (`url` is reserved for the legacy SSE transport):

```
{
  "mcpServers": {
    "dataddo": {
      "httpUrl": "https://headless.dataddo.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_ACCESS_TOKEN>"
      }
    }
  }
}
```

1. Restart Gemini CLI, then run the `/mcp` command to verify the `dataddo` server is connected and its tools are listed.

The settings file is stored in plain text - never commit a project-level `settings.json` containing a token to version control.

> 💡 **Gemini Code Assist**
> 
> 
> Gemini Code Assist agent mode in VS Code reads the same `~/.gemini/settings.json` file, so the configuration above also makes Dataddo tools available there.

## Try It Out

Ask Gemini CLI:

> Using the Dataddo tools, what is the current time in UTC?

## Troubleshooting

- **Server fails to connect.** Make sure you used `httpUrl` (not `url`) and the address is exactly `https://headless.dataddo.com/mcp`.
- **Authentication errors.** Dataddo access tokens expire; generate a fresh token and update the configuration. See [Authorization](/headless/docs/dataddo-api-authorization).