How connorcallison/google-ads-mcp works
Google Ads MCP is a local, write-capable MCP server and helper CLI for operating Google Ads accounts through the official API. The principal workflow is an MCP client invoking a tool, the server resolving and validating account settings, the gateway querying or mutating Google Ads, and write requests being audited before and after the provider call. The gateway also supports separate reporting, geographic targeting, and keyword-planning stages. The README documents several capabilities whose implementation details were not sampled; those relationships are shown at the documented level, without inferring unshown internal calls.
Main entry points: mcp_server.py MCP tools · google_ads.py Google Ads gateway · cli.py Helper CLI · audit.py Audit logger
Components 20
Operator interfaces
- MCP tools
src/google_ads_mcp/mcp_server.py - Helper CLI
src/google_ads_mcp/cli.py
Reporting and planning
- Customer access
src/google_ads_mcp/google_ads.py - GAQL reporting
src/google_ads_mcp/google_ads.py - Geo targeting
src/google_ads_mcp/google_ads.py - Keyword ideas
src/google_ads_mcp/google_ads.py - Search forecast
src/google_ads_mcp/google_ads.py
Account operations
- Google Ads gateway
src/google_ads_mcp/google_ads.py - Budget inspection
src/google_ads_mcp/google_ads.py - Budget updates
src/google_ads_mcp/google_ads.py - Campaign status
src/google_ads_mcp/google_ads.py - Conversion goals
src/google_ads_mcp/google_ads.py - Negative keywords
src/google_ads_mcp/google_ads.py - Recommendations
src/google_ads_mcp/google_ads.py
Safety and audit
- Account settings
src/google_ads_mcp/config.py - Write policy
src/google_ads_mcp/policy.py - Audit logger
src/google_ads_mcp/audit.py - JSONL audit files
Other components
- MCP client
- Google Ads API
Connections 20
- MCP client → MCP tools: invokes tools
README.md - MCP tools → Account settings: loads settings
src/google_ads_mcp/mcp_server.py - MCP tools → Google Ads gateway: dispatches requests
src/google_ads_mcp/mcp_server.py - MCP tools → Audit logger: records writes
src/google_ads_mcp/mcp_server.py - Helper CLI → Account settings: loads settings
src/google_ads_mcp/cli.py - Helper CLI → Google Ads gateway: runs queries
src/google_ads_mcp/cli.py - Google Ads gateway → Write policy: validates limits
src/google_ads_mcp/google_ads.py - Google Ads gateway → Google Ads API: calls API
src/google_ads_mcp/google_ads.py - MCP tools → Customer access: requests customer list
src/google_ads_mcp/mcp_server.py - MCP tools → GAQL reporting: runs queries
src/google_ads_mcp/mcp_server.py - MCP tools → Geo targeting: resolves places
src/google_ads_mcp/mcp_server.py - MCP tools → Keyword ideas: requests ideas
src/google_ads_mcp/mcp_server.py - MCP tools → Search forecast: requests forecast
src/google_ads_mcp/mcp_server.py - MCP tools → Budget inspection: inspects budgets
README.md - MCP tools → Budget updates: sets budgets
src/google_ads_mcp/mcp_server.py - MCP tools → Campaign status: changes status
src/google_ads_mcp/mcp_server.py - MCP tools → Conversion goals: updates goals
src/google_ads_mcp/mcp_server.py - MCP tools → Negative keywords: adds negatives
src/google_ads_mcp/mcp_server.py - MCP tools → Recommendations: applies recommendations
README.md - Audit logger → JSONL audit files: appends records
src/google_ads_mcp/audit.py