google-ads-analyzer

Provides a local MCP server that connects to the Google Ads API, exposing read tools (GAQL search, list accessible customer IDs) and additional write tools (add negative keywords, pause/enable campaigns, update campaign budgets, change bidding strategies, and pause/enable ad groups/ads) so an LLM/agent can analyze and manage Google Ads accounts.

Evaluated Mar 30, 2026 (21d ago)
Repo ↗ Ai Ml ai-ml mcp google-ads marketing-automation python api-integration automation campaign-management
⚙ Agent Friendliness
54
/ 100
Can an agent use this?
🔒 Security
72
/ 100
Is it safe for agents?
⚡ Reliability
26
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
78
Documentation
70
Error Messages
0
Auth Simplicity
65
Rate Limits
20

🔒 Security

TLS Enforcement
90
Auth Strength
75
Scope Granularity
70
Dep. Hygiene
45
Secret Handling
70

Uses Google ADC and an Ads developer token (stronger than no auth). The README indicates required OAuth scope for adwords access, implying OAuth-based security. However, the provided content does not mention least-privilege scopes per tool, TLS/verification details for the MCP transport, nor how secrets are handled/logged by the server. Write tools increase operational risk if not protected by agent-level confirmation and access control.

⚡ Reliability

Uptime/SLA
0
Version Stability
45
Breaking Changes
30
Error Recovery
30
AF Security Reliability

Best When

You want an agent connected to Google Ads that can both retrieve reporting data and perform specific write operations using Google’s official Ads API scopes/credentials.

Avoid When

You cannot tolerate the risk of the model triggering write tools (even if unintended) or you lack guardrails, least-privilege credentials, and monitoring/auditing for changes.

Use Cases

  • Agentic analysis of Google Ads performance via GAQL queries
  • Listing accessible Google Ads customer IDs for an authenticated user
  • Applying operational changes from natural language (e.g., pausing campaigns/ad groups/ads, updating budgets/bidding strategies)
  • Managing negative keywords at scale for campaigns via the assistant
  • Faster iteration cycles where an agent can inspect account data and then execute bounded changes

Not For

  • Unattended, fully-automated budget/strategy changes without human review
  • Accounts or operations requiring a separate approvals workflow/audit trail beyond what the README describes
  • Teams that cannot provide and manage Google Ads API credentials securely
  • Applications needing a hosted public API/SDK instead of a local MCP server

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: Google Ads API authentication via Google Application Default Credentials (ADC) or Google Ads API Python client config Google Ads developer token (GOOGLE_ADS_DEVELOPER_TOKEN) Optional login customer ID for manager-account access (GOOGLE_ADS_LOGIN_CUSTOMER_ID)
OAuth: Yes Scopes: Yes

Uses Google Application Default Credentials and requires the Google Ads API scope https://www.googleapis.com/auth/adwords (per README). OAuth complexity is managed by Google ADC; the MCP server setup requires correct environment variables and access permissions for the Ads account(s).

Pricing

Free tier: No
Requires CC: No

No pricing information in the provided README/repo metadata; costs would primarily be your own infrastructure plus Google Ads API usage (and any LLM tooling you connect to).

Agent Metadata

Pagination
none
Idempotent
False
Retry Guidance
Not documented

Known Gotchas

  • Write tools can materially change campaigns/budgets/bidding/keywords; agents must have guardrails/confirmation steps.
  • Many prompts require a customer ID; multi-customer workflows should ensure the correct customer context.
  • Negative keyword matching types (BROAD/PHRASE/EXACT) must be set correctly to avoid unintended keyword blocking.
  • Budget and bidding changes should be validated (currency/target values) before execution.
  • The README notes an extra header for usage data collection; ensure this is acceptable for your environment and that it does not leak sensitive info.

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for google-ads-analyzer.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-30.

8642
Packages Evaluated
17761
Need Evaluation
586
Need Re-evaluation
Community Powered