# Gemini CLI

Gemini CLI is Google's command-line AI tool that lets you explore and analyze data through natural language conversation directly in your terminal. By connecting Coupler.io to Gemini CLI, you can pull in business data from any source and ask questions, spot trends, and generate insights — all without leaving the command line.

## Why use Gemini CLI as a destination?

* **Terminal-native analysis** — ask Gemini questions about your data in plain English directly from the command line
* **Any source, one session** — connect Google Ads, TikTok Ads, Google Drive, or any other Coupler.io source, and analyze it all in one place
* **No credentials needed** — Gemini CLI accesses your data through a connector, so there are no database passwords or OAuth flows to manage on the destination side
* **Always fresh data** — schedule your data flow to refresh automatically so Gemini CLI always has up-to-date data to work with

## Prerequisites

* Gemini CLI installed on your machine
* A Google account with access to Gemini

## Quick start

{% hint style="success" %}
Install and configure Gemini CLI first, then create your data flow in Coupler.io. Having Gemini CLI ready before you run the flow means you can start querying your data immediately.
{% endhint %}

### How to connect

{% stepper %}
{% step %}
**Add a source to your data flow.** In Coupler.io, create a new data flow and add at least one source — for example, Google Ads, TikTok Ads, or any other supported integration.
{% endstep %}

{% step %}
**Select Gemini CLI as the destination.** In the destination step of your data flow, choose **Gemini CLI** from the list of available destinations.
{% endstep %}

{% step %}
**Add Coupler.io MCP server to Gemini**. Generate the proper command to add the MCP. It will look like `gemini mcp add coupler --transport=http --scope=user https://mcp.coupler.io/mcp/xxx`
{% endstep %}

{% step %}
**Authenticate Coupler.io MCP**. Use the following command inside Gemini CLI: `/mcp auth coupler`
{% endstep %}

{% step %}
**Run the data flow.** Click **Run** to execute the data flow manually. Once it completes successfully, your data is available to Gemini CLI. Open your terminal, start a Gemini CLI session, and begin asking questions about your dataset.
{% endstep %}
{% endstepper %}

## Supported features

| Feature              | Supported |
| -------------------- | --------- |
| Replace mode         | Yes       |
| Append mode          | No        |
| Automatic scheduling | Yes       |
| Type enforcement     | No        |
| Templates            | No        |