All Platforms
Gemini CLI

How to Connect Ad Platforms to Gemini CLI

Use Google Gemini CLI to analyze your advertising data across all connected platforms — right from your terminal.

5 min setupbeginnerUpdated 2026-02-11

Gemini CLI is Google's open-source command-line AI assistant. Unlike the Gemini web app, Gemini CLI supports MCP (Model Context Protocol) — which means you can connect it directly to your advertising data through Ad Superpowers.

Important: the Gemini web app and mobile app do not support MCP. This guide covers Gemini CLI, the terminal-based tool you install via npm. If you prefer a browser-based experience, check our guides for Claude or ChatGPT instead.

Once connected, you can query your Meta Ads, Google Ads, GA4, Google Search Console, LinkedIn Ads, and TikTok Ads data in natural language — all from your terminal. Ask for cross-platform comparisons, ROAS breakdowns, or a full audit of your ad accounts.

You will need Node.js 18+, a terminal, and an Ad Superpowers account. The Free plan covers Meta Ads, Google Ads, GA4, and Google Search Console.

The Old Way

Open Meta Ads Manager. Check performance. Switch to Google Ads. Check performance. Open GA4. Check traffic. Open a spreadsheet. Try to make sense of it all together. Fail.

The New Way

Open your terminal. Run gemini. Ask "How did all my ad platforms perform this week? Which channel gave me the best ROAS?" Get a unified answer with cross-platform comparisons.

What You Need

  • Node.js 18+ installed on your machine
  • A terminal (macOS Terminal, iTerm, Windows Terminal, etc.)
  • An Ad Superpowers account (Free or Pro depending on platforms)
  • 5 minutes to install and configure

Step-by-Step Setup

1

Create your Ad Superpowers account

Go to app.adsuperpowers.ai and sign up. Google sign-in is fastest. Connect all the ad platforms you want to analyze — the Free plan includes Meta Ads, Google Ads, GA4, and Google Search Console. The Pro plan adds LinkedIn, TikTok, Shopify, and Klaviyo.

Connect your platforms before setting up Gemini CLI so you can test the connection immediately.
2

Get your API key

Navigate to Settings in the Ad Superpowers dashboard. Generate an API key under "API Keys". Copy it — you will need it for the Gemini CLI configuration file.

3

Install Gemini CLI

Open your terminal and install Gemini CLI globally via npm: npm install -g @google/gemini-cli This installs the `gemini` command. You will need Node.js 18 or newer. Verify the installation by running `gemini --version`.

If you get a permission error on macOS/Linux, try: sudo npm install -g @google/gemini-cli
4

Configure the MCP connection

Create or edit the file ~/.gemini/settings.json and add the Ad Superpowers MCP server: { "mcpServers": { "adsuperpowers": { "url": "https://mcp.adsuperpowers.ai/v1", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } Replace YOUR_API_KEY with the API key you copied from the Ad Superpowers dashboard.

You can also store the API key in ~/.gemini/.env as AD_SUPERPOWERS_KEY=your_key and reference it in the config to avoid hardcoding secrets.
5

Verify the connection

Start Gemini CLI by running `gemini` in your terminal. Once it loads, type `/mcp list` to see all connected MCP servers. You should see "adsuperpowers" listed with the available tools. Then ask: "Show me my connected ad accounts" to confirm data access.

If Gemini CLI prompts you to approve MCP tool usage, type yes. You can add "trust": true to your settings.json config to skip confirmations in the future.
6

Ask your first cross-platform question

Now try something powerful: "Compare my Meta Ads and Google Ads performance this month — which platform gives me better ROAS?" This is the kind of cross-platform analysis that previously required exporting data from two different dashboards and building a spreadsheet comparison.

Gemini CLI has access to all 25 Ad Superpowers tools — campaign queries, insights, creative analysis, keyword research, and more across all connected platforms.

Try These Prompts

Once connected, try these prompts to explore your data. Click to copy.

Cross-platform analysis: the real advantage

Every ad platform tells you how it performed in isolation. Meta says your ROAS was 3.2x. Google Ads says 4.1x. TikTok says 2.8x. LinkedIn says 1.5x. But what does the full picture look like? Where should you shift budget? Which platform is actually driving incremental value?

These are the questions that matter most, and they are the hardest to answer because the data lives in separate dashboards with different metrics, different attribution models, and different reporting interfaces.

Connecting all your platforms to Gemini CLI through Ad Superpowers solves this. In a single terminal session, Gemini can pull data from every connected platform and give you a unified view. Ask for cross-platform comparisons and get them instantly:

Budget efficiency: "I spent €10,000 across Meta, Google, and TikTok last month. Which platform delivered the most conversions per euro?" Gemini pulls the data from all three and gives you a ranked answer.

Channel mix optimization: "Based on the last 90 days of data, what is the optimal budget split across my platforms?" Gemini analyzes conversion data, cost efficiency, and diminishing returns to suggest allocation changes.

Attribution reality check: "Meta claims 200 conversions, Google claims 150, and GA4 shows 180 total. Help me understand the discrepancy." Multi-platform attribution is one of the most confusing aspects of digital advertising — having all the data in one conversation makes it possible to actually reason through it.

See our integrations page for the full list of supported platforms and what data is available from each.

What data can Gemini CLI access?

Through the Ad Superpowers MCP server, Gemini CLI gets access to all connected platforms and their full data depth:

Meta Ads (Free plan): campaigns, ad sets, ads, creatives, 70+ metrics, audience breakdowns by age/gender/placement/device, historical data with flexible date ranges.

Google Ads (Free plan): campaigns, ad groups, keywords, search terms, quality scores, and the full power of GAQL queries across 50+ resources. Plus Keyword Planner for research.

Google Analytics 4 (Free plan): sessions, users, pageviews, conversions, traffic sources, engagement metrics, demographics, and real-time data.

Google Search Console (Free plan): organic search queries, click-through rates, positions, page performance, and indexing data.

LinkedIn Ads (Pro plan): campaigns, ad groups, ads, targeting data, lead gen metrics, and performance analytics.

TikTok Ads (Pro plan): campaigns, ad groups, ads, video metrics (completion rates, engagement), audience data, and creative asset performance.

All platforms share the same MCP connection, so switching between them in a conversation is seamless. Ask about Meta in one message and Google Ads in the next — Gemini CLI handles the context.

Why Gemini CLI for marketers?

Gemini CLI is a terminal tool, which might sound intimidating if you are used to browser-based AI. But it has real advantages for marketers who work with data:

Speed: terminal-based interactions are fast. No loading web pages, no waiting for UI elements. Type your question, get your answer.

Scriptable: you can pipe Gemini CLI output into files, scripts, or other tools. Generate a daily report and save it to a file. Combine it with cron jobs for automated analysis.

Google ecosystem: if you already use Google Ads and GA4, Gemini CLI gives you Google's AI model with direct access to those platforms (plus Meta, LinkedIn, TikTok through Ad Superpowers). The GAQL query language support means Gemini can construct advanced Google Ads queries on your behalf.

GA4 + Search Console synergy: combine your website analytics and organic search data with paid advertising data in a single conversation. Ask Gemini to find keywords where you rank organically on page 2 but are not bidding on in Google Ads — instant opportunities.

The non-Google platforms — Meta, LinkedIn, TikTok — are equally accessible through Ad Superpowers. Gemini does not prioritize Google Ads data over others; it queries whatever you ask about.

Troubleshooting

If Gemini CLI cannot access your ad data:

1. Run /mcp list inside Gemini CLI to check if adsuperpowers appears. If not, your settings.json has an error. 2. Check that ~/.gemini/settings.json exists and contains valid JSON. A common mistake is a trailing comma or missing quote. 3. Verify the MCP server URL is exactly https://mcp.adsuperpowers.ai/v1 (no trailing slash). 4. Check your API key. You can regenerate it in the Ad Superpowers dashboard under Settings. 5. Make sure you have connected at least one ad platform in the Ad Superpowers dashboard. 6. Try restarting Gemini CLI — exit with /quit and run gemini again. 7. If you see permission prompts for MCP tools, type yes to approve them.

Node.js version: Gemini CLI requires Node.js 18+. Check with node --version.

Performance: most queries return in 2-5 seconds. Cross-platform queries that pull data from multiple platforms may take slightly longer as each platform is queried in sequence.

For more help, visit our troubleshooting docs or reach out through the Ad Superpowers dashboard.

Frequently Asked Questions

Related Guides

Learn More About All Platforms

See all tools, features, and technical details for the All Platforms integration.

View Integration

Ready to Connect?

Create your free account and set up All Platforms with Gemini CLI in under 5 minutes.