Integration · Gemini CLI × TikTok Ads
Run TikTok Ads inside Gemini CLI
NotFair connects Gemini CLI to live TikTok Ads through the same hosted MCP endpoint used across the product. Campaigns, ad groups, ads, reporting, and creative assets.
Connect your TikTok Ads account
Authorize once at notfair.co — then open Gemini CLI and start asking real questions about your account.
Setup
Connect Gemini CLI in three steps
Gemini CLI uses NotFair's hosted Streamable HTTP endpoint. NotFair hosts TikTok Ads OAuth. You authorize advertiser accounts without building a TikTok developer app for the MCP client.
1. Add the hosted MCP server
Gemini CLI can call a remote MCP endpoint. Point it at NotFair's Streamable HTTP URL.
{ "mcpServers": { "NotFair-TikTokAds": { "url": "https://notfair.co/api/mcp/notfair" } } }2. Authorize TikTok Ads
Open /connect/tiktok-ads on notfair.co, complete the hosted connection, and select the accounts or properties Gemini CLI may use.
3. Verify with a read
Ask Gemini CLI to list TikTok Ads tools in this connection, excluding other platforms.
Capabilities
What Gemini CLI can do with NotFair
Read live TikTok Ads data
Campaigns, ad groups, ads, reporting, and creative assets.
Counted tool surface
96 TikTok Ads tools, measured from the production registrar and guarded by a drift test.
Hosted credentials
NotFair hosts TikTok Ads OAuth. You authorize advertiser accounts without building a TikTok developer app for the MCP client.
Platform-true writes
Create delivery entities DISABLE unless activation is explicitly requested. Previews are local validation; TikTok validates on apply. Writes wait for approval and record provenance. adImageUpload and adVideoUpload accept public HTTPS URLs, not local files. API code must be zero even when HTTP is 200.
Example workflows
Prompts that lead to real account work
Wasted-spend triage
“Audit my TikTok Ads account for the last 30 days. Rank the three highest-cost problems with evidence. Do not change anything until I approve.”
A ranked diagnosis from live tools, with staged writes that wait for approval.
Creative or delivery review
“Show frequency, spend, and delivery for the active TikTok Ads entities. Flag creative fatigue or stalled learning. Preview any pause.”
Platform-true delivery review. Create delivery entities DISABLE unless activation is explicitly requested. Previews are local validation; TikTok validates on apply. Writes wait for approval and record provenance.
Budget shift preview
“Propose moving budget from the worst entity to the best, showing current versus proposed values. Do not execute.”
An exact proposal you can approve or reject. NotFair does not claim Google Ads impact snapshots on this platform.
Why NotFair for Gemini CLI + TikTok Ads
The hosted MCP endpoint is the same. The TikTok Ads contract is not. NotFair keeps tool counts, OAuth, and write limits honest for this platform.
- 96 TikTok Ads tools — not a vendor-wide total reused as a TikTok Ads count
- NotFair hosts TikTok Ads OAuth. You authorize advertiser accounts without building a TikTok developer app for the MCP client.
- Create delivery entities DISABLE unless activation is explicitly requested. Previews are local validation; TikTok validates on apply. Writes wait for approval and record provenance.
- Same remote endpoint in Claude, Codex, Cursor, Windsurf, Gemini CLI, and OpenClaw
FAQ
Common questions about using Gemini CLI with Google Ads through NotFair.
Yes. NotFair's hosted MCP endpoint is the same across clients. Gemini CLI speaks MCP and can call the same tools. TikTok publishes a first-party Agentic Hub / Marketing API MCP.
NotFair does not copy Google Ads impact snapshots or undo onto TikTok Ads. Create delivery entities DISABLE unless activation is explicitly requested. Previews are local validation; TikTok validates on apply. Writes wait for approval and record provenance.
NotFair advertises 96 TikTok Ads tools.
Other integrations
Switching clients, or curious how this compares?
ChatGPT + Google Ads
NotFair connects ChatGPT to live TikTok Ads through the same hosted MCP endpoint used across the product. Campaigns, ad groups, ads, reporting, and creative assets.
Claude Code + Google Ads
NotFair connects Claude Code to live TikTok Ads through the same hosted MCP endpoint used across the product. Campaigns, ad groups, ads, reporting, and creative assets.
Cursor + Google Ads
NotFair connects Cursor to live TikTok Ads through the same hosted MCP endpoint used across the product. Campaigns, ad groups, ads, reporting, and creative assets.