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

# Connect Gemini CLI to Ad Platforms | Adspirer

> Connect Gemini CLI to Adspirer MCP in 2 minutes. Manage Google Ads, Meta Ads, Amazon Ads, ChatGPT Ads, LinkedIn Ads, and TikTok Ads from your terminal with 340+ tools.

Manage all your ad campaigns from the terminal using Google's Gemini CLI. One command to install, 340+ tools to use.

## Prerequisites

<Note>
  * Gemini CLI installed:

  ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
  npm install -g @google/gemini-cli
  ```

  * An Adspirer account ([free to start](https://adspirer.ai/sign-up?utm_source=docs\&utm_medium=page\&utm_content=signup))
  * At least one ad platform account: Google Ads, Meta Ads, Amazon Ads, ChatGPT Ads, LinkedIn Ads, or TikTok Ads
</Note>

## Setup

<Steps>
  <Step title="Install the Adspirer Extension">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    gemini extensions install https://github.com/amekala/ads-mcp
    ```

    This installs the Adspirer MCP server, 5 slash commands, and the ad campaign management skill.
  </Step>

  <Step title="Authenticate with Adspirer">
    Run Gemini CLI and ask it anything about your ad accounts:

    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
    gemini
    ```

    ```
    Check my connected ad platforms
    ```

    Your browser opens automatically for OAuth sign-in. Sign in with your Adspirer account and authorize access. Return to Gemini CLI — you're connected.
  </Step>

  <Step title="Try It Now">
    <Card title="Sign up for Adspirer — free to start" icon="rocket" href="https://adspirer.ai/sign-up?utm_source=docs&utm_medium=setup-cta&utm_content=gemini-cli" horizontal>
      15 free tool calls/month. No credit card required. Connect your ad accounts in 2 minutes.
    </Card>
  </Step>
</Steps>

### Verify Your Setup

Run a test prompt:

```
Check my connected ad platforms
```

You should see a table showing your connected accounts across Google Ads, Meta Ads, Amazon Ads, ChatGPT Ads, LinkedIn Ads, and TikTok Ads — along with account IDs, names, and connection status.

<Check>
  You're connected. Gemini CLI now has access to 340+ advertising tools from your terminal.
</Check>

## Slash Commands

The extension includes 5 slash commands that trigger proven workflows:

| Command                        | What it Does                                                         |
| ------------------------------ | -------------------------------------------------------------------- |
| `/adspirer:setup`              | Bootstrap a brand workspace — connect accounts, scan docs, pull data |
| `/adspirer:performance-review` | Cross-platform performance scorecard with KPI comparison             |
| `/adspirer:write-ad-copy`      | Brand-voice ad copy from real keyword and performance data           |
| `/adspirer:wasted-spend`       | Find and fix wasted spend across all platforms                       |
| `/adspirer:refresh`            | Re-scan docs and update context with latest data                     |

You don't need to remember these — just describe what you want and Gemini will use the right workflow.

## What You Can Do

340+ tools across 6 ad platforms. Here's what matters:

| Platform         | Tools | Key Capabilities                                                                                                                          |
| ---------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Google Ads**   | 39    | Keyword research with real CPC data, Search & PMax campaigns, wasted spend analysis, budget optimization, ad extensions, asset management |
| **LinkedIn Ads** | 28    | Sponsored content, lead gen forms, B2B targeting (job titles, industries, seniority), creative performance analysis                       |
| **Meta Ads**     | 20    | Image/video/carousel campaigns, audience targeting, creative fatigue detection, placement optimization                                    |
| **TikTok Ads**   | 4     | In-feed campaigns, asset validation, performance analysis                                                                                 |

Plus 8 automation tools: scheduled briefs, performance monitors, cross-platform reports.

## Example Prompts

What to actually say once you're set up:

### Google Search Campaign

<Prompt description="Google Search campaign with keyword research grouped by intent." actions={["copy"]}>
  Create a Google Ads search campaign for my SaaS product:

  * Product: project management tool for remote teams
  * Target: team leads and ops managers at companies with 20-200 employees
  * Budget: \$60/day
  * Research keywords with real CPC data first
  * Group keywords by intent (branded, competitor, feature-based)
</Prompt>

### Google PMax Campaign

<Prompt description="Performance Max campaign across all Google channels." actions={["copy"]}>
  Set up a Performance Max campaign for my e-commerce store:

  * Product: organic dog treats, \$24.99 avg order value
  * Target ROAS: 400%
  * I have product images at these URLs: \[paste URLs]
  * Write 5 headlines and 3 descriptions
  * Use my existing Google Merchant Center feed
</Prompt>

### Cross-Platform Audit

<Prompt description="Multi-platform audit with prioritized action list and savings estimate." actions={["copy"]}>
  Audit all my ad accounts for the last 30 days:

  * Google: find wasted spend (keywords with clicks but zero conversions)
  * Meta: check for creative fatigue (frequency > 3, declining CTR)
  * LinkedIn: compare CPA across audience segments

  Give me a prioritized action list with estimated monthly savings.
</Prompt>

## Safety Features

Adspirer enforces safety rules to prevent accidental spend:

* **All campaigns created PAUSED:** You review before they go live
* **User confirmation required:** Gemini asks before any action that affects spend
* **Read-before-write:** Research and validation before campaign creation
* **Connection status checks:** Always verifies you're managing the right account first
* **No automatic retries:** If a campaign creation fails, Gemini won't retry without asking

## Troubleshooting

### Extension not installing

Make sure you have the latest Gemini CLI:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npm update -g @google/gemini-cli
```

Then retry the install:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gemini extensions install https://github.com/amekala/ads-mcp
```

### Authentication not working

The OAuth flow opens your default browser automatically. If it doesn't:

* Check your default browser settings
* Try clearing browser cache or using a different browser
* Disable ad blockers temporarily — some interfere with OAuth redirects

### Tools not working after connecting

Check your Adspirer account status at [adspirer.ai](https://adspirer.ai?utm_source=docs\&utm_medium=page\&utm_content=account). Free accounts get 15 tool calls/month. If you've hit the limit, upgrade to Plus ($49/mo for 150 calls) or Pro ($99/mo for 600 calls).

### Slash commands not recognized

Make sure the extension installed successfully:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
gemini extensions list
```

You should see `ads-mcp` in the list. If not, reinstall the extension.

## FAQ

<AccordionGroup>
  <Accordion title="What is Gemini CLI?">
    Gemini CLI is Google's official command-line AI tool, powered by the Gemini model. It lets you query codebases, generate apps, and automate workflows from your terminal. Install it with `npm install -g @google/gemini-cli`.
  </Accordion>

  <Accordion title="How is this different from Claude Code?">
    Both are terminal-based AI tools that connect to Adspirer via MCP. Gemini CLI is powered by Google's Gemini model. Claude Code is powered by Anthropic's Claude model. Both have full access to the same 340+ advertising tools. Choose whichever AI model you prefer.
  </Accordion>

  <Accordion title="Do I need a Google Cloud account?">
    No. Gemini CLI is free to use. You only need an Adspirer account to connect to your ad platforms.
  </Accordion>

  <Accordion title="Can I use both Gemini CLI and Claude Code?">
    Yes. Your Adspirer account works with every supported AI client. All clients share the same tool call quota. See [Multi-Client](/knowledge-base/multi-client) for details.
  </Accordion>

  <Accordion title="How much does this cost?">
    Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: $49/mo for 150 calls. Pro: $99/mo for 600 calls. Max: \$199/mo for 3,000 calls. See the [full pricing breakdown](https://www.adspirer.com/pricing).
  </Accordion>

  <Accordion title="Is my data safe?">
    Yes. Adspirer uses OAuth 2.1 with PKCE — we never see your passwords. Your ad account credentials live with Google/Meta/LinkedIn/TikTok. We only get read/write permissions you explicitly authorize. You can revoke access anytime from your ad platform's security settings.
  </Accordion>
</AccordionGroup>

## Related Documentation

* [Google Ads Integration Guide](/ad-platforms/google-ads)
* [Gemini CLI Extensions Gallery](https://geminicli.com/extensions/?name=amekalaads-mcp)
* [Pricing & Plans](https://www.adspirer.com/pricing)
* [All Documentation](/introduction)