> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/destinations/categories/ai/gemini.md).

# 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        |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/destinations/categories/ai/gemini.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.