How fgribreau/mcp-google-ads works
mcp-google-ads is an MCP server that lets Claude inspect and manage Google Ads accounts. The principal workflow is a tool request, a Google Ads read or mutation draft, a reviewable preview, then explicit confirmation before a write is applied and audited. Its tool surface also covers reporting, keyword planning, audiences, bidding, geo targeting, policy, conversions, and other account operations. The source excerpts show the MCP dispatch and parts of the safety and client layers; README statements support the broader tool coverage. Some subsystem links are therefore documented rather than verified in sampled implementation.
Main entry points: client.rs Google Ads client · lib.rs Tool dispatch · keywords_write.rs Keyword tools · confirm.rs Apply confirmation
Components 20
MCP server
- Tool dispatch
src/lib.rs
Ads operations
- Campaign reporting
src/tools/campaigns.rs - Keyword tools
src/tools/keywords_write.rs - Negative keyword lists
src/tools/shared_sets_write.rs - Campaign changes
src/tools/campaigns_write.rs - Demographic tools
src/tools/demographics.rs - Other Ads capabilities
src/tools
Safety workflow
- Pending change plans
src/safety/preview.rs - Mutation guardrails
src/safety/guards.rs - Policy exemptions
src/safety/policy_exemption.rs - Apply confirmation
src/tools/confirm.rs - Mutation audit log
src/safety/audit.rs
API foundation
- Environment config
src/config.rs - OAuth authentication
src/auth.rs - Google Ads client
src/client.rs - GAQL formatting
src/gaql.rs - Shared domain models
src/models/demographic.rs - API error handling
src/error.rs
Other components
- Claude / MCP host
- Google Ads API
Connections 26
- Claude / MCP host → Tool dispatch: sends tool requests
README.md - Tool dispatch → Campaign reporting: dispatches reads
src/lib.rs - Tool dispatch → Keyword tools: dispatches writes
src/lib.rs - Tool dispatch → Demographic tools: dispatches reads
src/lib.rs - Tool dispatch → Other Ads capabilities: exposes tools
README.md - Tool dispatch → Environment config: uses configuration
src/lib.rs - Campaign reporting → Google Ads client: queries account
src/tools/campaigns.rs - Campaign reporting → GAQL formatting: uses query helpers
src/tools/campaigns.rs - Keyword tools → Google Ads client: mutates account
src/tools/keywords_write.rs - Keyword tools → Pending change plans: creates preview
src/tools/keywords_write.rs - Negative keyword lists → Google Ads client: mutates account
src/tools/shared_sets_write.rs - Negative keyword lists → Pending change plans: creates preview
src/tools/shared_sets_write.rs - Campaign changes → Pending change plans: creates preview
src/tools/campaigns_write.rs - Demographic tools → Google Ads client: queries account
src/tools/demographics.rs - Demographic tools → Shared domain models: uses models
src/models/demographic.rs - Pending change plans → Apply confirmation: requests confirmation
src/safety/preview.rs - Apply confirmation → Google Ads client: applies mutations
src/tools/confirm.rs - Apply confirmation → Mutation audit log: records mutation
src/tools/confirm.rs - Apply confirmation → Policy exemptions: handles policy errors
src/tools/confirm.rs - Campaign changes → Mutation guardrails: checks write limits
src/tools/campaigns_write.rs - Google Ads client → OAuth authentication: obtains credentials
src/client.rs - OAuth authentication → Environment config: reads settings
src/auth.rs - Google Ads client → Google Ads API: sends API requests
src/client.rs - Google Ads client → API error handling: parses API failures
src/client.rs - Keyword tools → Policy exemptions: supports exemptions
src/tools/keywords_write.rs - Other Ads capabilities → Google Ads client: accesses API
src/tools/campaigns_write.rs