Gemini CLI

🚧 Prototype

The Dataddo MCP server is an early prototype. See the Dataddo MCP Server overview for its current capabilities and roadmap.

Connect the Dataddo MCP server to 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.
• 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>"
      }
    }
  }
}

3. 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.