Prerequisites
- Gemini CLI installed:
- An Adspirer account (free to start)
- At least one ad platform account: Google Ads, Meta Ads, Amazon Ads, ChatGPT Ads, LinkedIn Ads, or TikTok Ads
Setup
1
Install the Adspirer Extension
2
Authenticate with Adspirer
Run Gemini CLI and ask it anything about your ad accounts:Your browser opens automatically for OAuth sign-in. Sign in with your Adspirer account and authorize access. Return to Gemini CLI — you’re connected.
3
Try It Now
Sign up for Adspirer — free to start
15 free tool calls/month. No credit card required. Connect your ad accounts in 2 minutes.
Verify Your Setup
Run a test prompt:You’re connected. Gemini CLI now has access to 400+ advertising tools from your terminal.
Slash Commands
The extension includes 5 slash commands that trigger proven workflows:
You don’t need to remember these — just describe what you want and Gemini will use the right workflow.
What You Can Do
400+ tools across 6 ad platforms. Here’s what matters:
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
Google Search campaign with keyword research grouped by intent.
Google PMax Campaign
Performance Max campaign across all Google channels.
Cross-Platform Audit
Multi-platform audit with prioritized action list and savings estimate.
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: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. Free accounts get 15 tool calls/month. If you’ve hit the limit, upgrade to Plus (99/mo for 600 calls).Slash commands not recognized
Make sure the extension installed successfully:ads-mcp in the list. If not, reinstall the extension.
FAQ
What is Gemini CLI?
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.How is this different from Claude Code?
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 400+ advertising tools. Choose whichever AI model you prefer.
Do I need a Google Cloud account?
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.
Can I use both Gemini CLI and Claude Code?
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 for details.
How much does this cost?
How much does this cost?
Adspirer pricing is based on tool calls, not ad spend. Free tier: 15 calls/month. Plus: 99/mo for 600 calls. Max: $199/mo for 3,000 calls. See the full pricing breakdown.
Is my data safe?
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.