Skip to content
Agentmart
Submit a tool

Google Ads MCP

Unofficial Google Ads MCP for campaigns, keywords, budgets, and gated mutations.

Connector by davidmosiah · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 4
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/davidmosiah-google-ads-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Unofficial Google Ads MCP for campaigns, keywords, budgets, and gated mutations.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
20 read · 2 write · 8 delete
Secrets
2 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 30

Read from the source code; the running server may list different tools.

Read 20 · Look things up without changing anything.

  • google_ads_agent_manifest
  • google_ads_cache_status
  • google_ads_capabilities
  • google_ads_connection_status
  • google_ads_daily_report
  • google_ads_data_inventory
  • google_ads_find_waste
  • google_ads_get_account_performance
  • google_ads_get_auth_url
  • google_ads_get_campaign
  • google_ads_get_campaign_performance
  • google_ads_get_keyword_performance
Show 8 more tools
  • google_ads_list_accounts
  • google_ads_list_ad_groups
  • google_ads_list_campaigns
  • google_ads_list_keywords
  • google_ads_onboarding
  • google_ads_privacy_audit
  • google_ads_profile_get
  • google_ads_quick_wins

Write 2 · Create, change, send or run things.

  • google_ads_exchange_code
  • google_ads_profile_update

Delete 8 · Delete, drop, revoke or wipe things.

  • google_ads_clear_cache
  • google_ads_pause_campaign
  • google_ads_pause_keyword
  • google_ads_resume_campaign
  • google_ads_resume_keyword
  • google_ads_revoke_access
  • google_ads_set_campaign_budget_micros
  • google_ads_set_keyword_bid_micros

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • GOOGLE_ADS_CLIENT_SECRET
  • GOOGLE_ADS_DEVELOPER_TOKEN

Other settings (environment variables or headers).

  • GOOGLE_ADS_ALLOW_MUTATIONS
  • GOOGLE_ADS_CACHE
  • GOOGLE_ADS_CACHE_PATH
  • GOOGLE_ADS_CACHE_TTL_SECONDS
  • GOOGLE_ADS_CLIENT_ID
  • GOOGLE_ADS_LOGIN_CUSTOMER_ID
  • GOOGLE_ADS_NO_RETRY
  • GOOGLE_ADS_PRIVACY_MODE
  • GOOGLE_ADS_REDIRECT_URI
  • GOOGLE_ADS_TOKEN_PATH

Network hosts it talks to 9

  • accounts.google.com · found in code
  • developers.google.com · found in code
  • example.test · found in code
  • github.com · found in code
  • glama.ai · found in code
  • googleads.googleapis.com · found in code
  • googleapis.com · found in code
  • myaccount.google.com · found in code
  • oauth2.googleapis.com · found in code

Files it touches

  • Your home directory (~)
  • ~/.hermes/config.yaml
  • ~/.hermes/skills/google-ads-mcp/SKILL.md

Tools (30)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • google_ads_agent_manifestGoogle Ads Agent Manifestread-only

    Machine-readable install, runtime, and client guidance for AI agents operating the Google Ads MCP. Does not read Google Ads or expose secrets.

  • google_ads_cache_statusGoogle Ads Cache Statusread-only

    Return the SQLite GAQL-response cache status: enabled flag, on-disk path, entry count, oldest entry age, and default TTL. Read-only — never calls Google Ads and does not require credentials.

  • google_ads_capabilitiesGoogle Ads MCP Capabilitiesread-only

    Explain supported Google Ads data, mutation gating, privacy modes, and recommended agent workflow. Does not read Google Ads or expose secrets.

  • google_ads_clear_cacheGoogle Ads Clear Cache

    Delete all entries from the local SQLite GAQL-response cache. Does NOT touch Google Ads — only affects local memoization. Not gated by GOOGLE_ADS_ALLOW_MUTATIONS because nothing in your ad account changes. Does not require credentials.

  • google_ads_connection_statusGoogle Ads Connection Statusread-only

    Check whether local Google Ads env vars, token file, Node version, privacy mode, mutation gate, and retry settings are ready. Does not call Google Ads or expose secrets.

  • google_ads_daily_reportDaily Performance Reportread-only

    Synthetic daily performance snapshot. Pulls YESTERDAY + LAST_7_DAYS + LAST_30_DAYS aggregates for a customer, optionally alerts when CPC exceeds cpc_alert_threshold. Pure-read workflow tool — never mutates.

  • google_ads_data_inventoryGoogle Ads Data Inventoryread-only

    List supported Google Ads data domains, scopes, privacy boundary, and recommended first calls. Does not call Google Ads APIs or expose user data.

  • google_ads_exchange_codeExchange Google OAuth Code

    Exchange a Google OAuth authorization code for local tokens. Tokens stored at ~/.google-ads-mcp/tokens.json with 0600 perms; never returned in the response.

  • google_ads_find_wasteFind Waste Keywords (read-only)read-only

    Identify keywords matching the 'high cost + zero conversions' waste pattern (inspiration from script #1). Returns a ranked list of candidates — NEVER pauses anything. Pair with google_ads_pause_keyword (gated) after user confirmation.

  • google_ads_get_account_performanceGet Account Performanceread-only

    Aggregate performance metrics (impressions, clicks, cost_micros, ctr, average_cpc, conversions) for the customer over a date range.

  • google_ads_get_auth_urlGet Google OAuth URLread-only

    Generate a Google OAuth authorization URL for the Google Ads API. Does not read or modify Google Ads data. Use this first when no local token exists.

  • google_ads_get_campaignGet Google Ads Campaignread-only

    Get a single campaign with budget, bidding strategy, and status. Returns the linked campaign_budget id (use it with google_ads_set_campaign_budget_micros).

  • google_ads_get_campaign_performanceGet Campaign Performanceread-only

    Per-campaign performance metrics over a date range. Filter to a single campaign with campaign_id.

  • google_ads_get_keyword_performanceGet Keyword Performanceread-only

    Per-keyword performance metrics over a date range. Returns clicks, cost_micros, ctr, average_cpc, conversions, conversion_rate. Filter with campaign_id, ad_group_id, or min_clicks.

  • google_ads_list_accountsList Accessible Customer Accountsread-only

    List all customer accounts the authenticated user can access. For a manager (MCC) account, this includes every child customer.

Show 15 more tools
  • google_ads_list_ad_groupsList Google Ads Ad Groups

    List ad groups under a campaign (or all campaigns) in a customer.

  • google_ads_list_campaignsList Google Ads Campaigns

    List campaigns under a Google Ads customer. Returns id, name, status, advertising_channel_type, bidding_strategy_type, and campaign_budget linkage.

  • google_ads_list_keywordsList Google Ads Keywords

    List keyword criteria under a campaign or ad group. Returns criterion_id, keyword text, match type, status, and cpc_bid_micros.

  • google_ads_onboardingOnboarding (shared Delx profile)read-only

    Return the 11-question Delx onboarding flow plus the current profile state and missing critical fields. Same profile reused across all Delx MCPs.

  • google_ads_pause_campaignPause Campaign (gated mutation)can change or delete data

    Pause an entire campaign by id. GATED.

  • google_ads_pause_keywordPause Keyword (gated mutation)can change or delete data

    Pause a single keyword by criterion_id. GATED: requires GOOGLE_ADS_ALLOW_MUTATIONS enabled AND explicit_user_intent. Ask the user first.

  • google_ads_privacy_auditGoogle Ads Privacy Auditread-only

    Return the local privacy, mutation-gate, cache, token-path, env-presence and redaction posture without revealing secret values.

  • google_ads_profile_getProfile Get (shared Delx profile)read-only

    Read the shared Delx profile (~/.delx-wellness/profile.json). Returns the user's preferred name, language, timezone, etc. Cross-tool — same profile is shared with other Delx MCPs. Read-only.

  • google_ads_profile_updateProfile Update (shared Delx profile)

    Persist a partial patch to the shared Delx profile (~/.delx-wellness/profile.json). REQUIRES explicit_user_intent=true. NEVER stores secrets — writes will be rejected at validation time.

  • google_ads_quick_winsFind Quick-Win Keywords (read-only)read-only

    Identify keywords with LOW CPC + HIGH CTR + at-least-some conversions — candidates to RAISE the bid on. Inverse of google_ads_find_waste. Returns a ranked list with a recommended_bid_micros (current + 25%, capped at 2x). NEVER changes bids; pair with google_ads_set_keyword_bid_micros (gated) after user confirmation.

  • google_ads_resume_campaignResume Campaign (gated mutation)can change or delete data

    Resume (enable) a paused campaign by id. GATED.

  • google_ads_resume_keywordResume Keyword (gated mutation)can change or delete data

    Resume (enable) a single paused keyword by criterion_id. GATED.

  • google_ads_revoke_accessRevoke Google Ads Accesscan change or delete data

    Revoke the current Google OAuth grant and delete local tokens. Use only when the user explicitly wants to disconnect Google Ads.

  • google_ads_set_campaign_budget_microsSet Campaign Budget (gated mutation)can change or delete data

    Update a campaign budget's amount_micros. GATED. campaign_budget_id is NOT the campaign id — discover it via google_ads_get_campaign (campaign_budget.id).

  • google_ads_set_keyword_bid_microsSet Keyword Bid (gated mutation)can change or delete data

    Update the cpc_bid_micros for a keyword criterion. GATED. Bid must be in micros (10_000 = $0.01).

Signals

Stars
4
Forks
0
Open issues
1
Last commit
Oct 17, 2026 (11 days ago)
Last release
Aug 29, 2026 (2 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.davidmosiah/google-ads-mcp
Version
0.1.3
Auth
API key
Packages
npm google-ads-mcp-unofficial
License
MIT
Repository
github.com/davidmosiah/google-ads-mcp-unofficial
Website
github.com/davidmosiah/google-ads-mcp-unofficial
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registrygithub-graphql

More from davidmosiah

Cite this page

Google Ads MCP. Agent Mart. https://agentmart.dev/connectors/davidmosiah-google-ads-mcp (last updated 2026-10-25)