Ads Connector

Manage your Google Ads from Claude.

Connect your Google Ads account once via OAuth. Then ask Claude to pull campaign reports, audit search terms, adjust budgets, and block wasted spend — without touching a dashboard or copy-pasting anything.

Get started — $99/mo How it works What you can do

Your credentials never leave

You connect your Google Ads account via OAuth on htmltoolz.com. Only your HTMLToolz API key travels to Claude. Your ad credentials are encrypted at rest and never exposed to any AI client.

Google Ads, full coverage

Six read methods plus three safe write operations: pause/enable campaigns, update budgets, add negative keywords. All new campaigns start PAUSED — nothing goes live without your say.

Works in any MCP client

One npm package, one API key. Use it in Claude Code, Claude.ai, Cursor, Windsurf, or any MCP-capable assistant. The connector talks to HTMLToolz; HTMLToolz talks to Google.

How it works

Subscribe and connect Upgrade to the Ads plan ($99/mo or $79/mo annual). Then go to Account → Ads and click "Connect Google Ads" — a standard OAuth screen, no passwords shared.
Install the MCP package Add htmltoolz-ads-mcp to your MCP client. It needs only your HTMLToolz API key — no Google tokens, no client secrets.
Start asking Ask Claude to pull a campaign report, find your top search terms, check where budget is going, or pause a campaign. The connector routes everything through HTMLToolz to your connected Google Ads account.

What you can do

Nine tools across reporting, research, and safe writes. All run against your connected account — nothing is simulated.

Reporting & research

google_ads_list_accountsAll customer accounts your login can access.

google_ads_list_campaignsCampaigns with status, channel type, and daily budget.

google_ads_campaign_reportImpressions, clicks, cost, conversions, CTR, avg CPC per campaign.

google_ads_search_terms_reportTop queries by cost — find what's burning budget.

google_ads_keyword_ideasSeed keywords → avg monthly searches + competition.

google_ads_searchRaw GAQL query — pull any data the API exposes.

Safe writes Ads plan includes write access

google_ads_update_campaign_statusEnable or pause a campaign.

google_ads_update_campaign_budgetSet a campaign's daily budget (account currency).

google_ads_add_campaign_negative_keywordAdd a negative keyword (broad, phrase, or exact).

Write operations are logged to your HTMLToolz activity log. All campaigns created via the API start in PAUSED status — nothing goes live without you.

Setup

You need an Ads plan API key (htk_live_*) and a connected Google Ads account. Both are set up at your account page.

Claude Code

claude mcp add --transport stdio htmltoolz-ads -- npx htmltoolz-ads-mcp \
  --env HTMLTOOLZ_API_KEY=htk_live_YOUR_KEY

JSON config (Claude Desktop / Cursor / Windsurf)

{
  "mcpServers": {
    "htmltoolz-ads": {
      "command": "npx",
      "args": ["htmltoolz-ads-mcp"],
      "env": {
        "HTMLTOOLZ_API_KEY": "htk_live_YOUR_KEY"
      }
    }
  }
}

Verify the connection

ads_connection_status

Ask Claude to run ads_connection_status — it returns your connected platforms, account labels, write access status, and today's usage.

Example prompts

"Pull a campaign report for last 30 days and tell me which campaigns have the worst CTR."

"Show me the top 20 search terms by cost from last week. Flag anything that looks off-topic."

"Pause all campaigns with zero conversions in the last 14 days."

"Generate keyword ideas for 'email marketing software' and sort by monthly search volume."

"What is my total spend this month broken down by campaign?"

"Add 'free' as a negative keyword to campaign 12345678."

Microsoft Ads

OAuth sign-in for Microsoft Advertising is available now — connect your account from Account → Ads. Full campaign management and reporting is in progress and will be added in a future update. Check the changelog for updates.

Pricing

$99/month

Or $948/year ($79/month effective)

Everything in Pro
Google Ads OAuth connector
Microsoft Ads sign-in (beta)
All 9 read & write tools
5,000 ad tool calls/day
Works in any MCP client

Subscribe Connect an account

What's included

The Ads plan includes a full Pro subscription plus the ads connector entitlement. You get the browser extension, API access, MCP connector, and cloud prompt sync — plus the ability to connect your ad accounts and use all 9 ads tools.

Cancelable anytime

Monthly plans cancel at the end of the billing period. Your Google Ads connection is disconnected when you downgrade. Annual plans are non-refundable after the first 7 days.

Questions?

FAQ

Does my Google Ads password go to Claude?: No. You sign in directly with Google via OAuth on htmltoolz.com. Your Google credentials never pass through Claude or the MCP package. Only your HTMLToolz key is stored in your MCP config.
Can this make changes to my live campaigns?: Only if you explicitly ask it to, and only the three write operations listed above. Write access is part of the Ads plan. Every write is logged. Campaigns created through the API always start PAUSED.
What happens to my data in transit?: Your API key goes from your MCP client to HTMLToolz over HTTPS. HTMLToolz retrieves your encrypted Google Ads OAuth token, calls the Google Ads API, and returns the result. Google Ads data passes through HTMLToolz's servers but is not stored or used for any other purpose.
Can I use this on a Team or Agency plan?: The Ads add-on is a separate subscription tier today. Each person who needs ad account access subscribes to the Ads plan individually. Multi-seat Ads plans are on the roadmap.
What about Facebook, TikTok, or LinkedIn ads?: Google Ads is live. Microsoft Ads OAuth is connected with full management coming soon. Meta, Reddit, TikTok, and LinkedIn are on the roadmap — watch the changelog.
Is the npm package published?: The package is available as htmltoolz-ads-mcp. If npx htmltoolz-ads-mcp doesn't resolve yet, use the repo-based config below while the registry listing propagates.