gamm: Google Ads MCP Manager

gamm lets AI agents read Google Ads freely and change it only with a person's approval. It is an MCP server you run yourself. It holds the one Google credential, gives each agent its own key, logs every call, and applies a change only after the approver confirms it with a passkey (Face ID, Touch ID or a security key).

agents ──(HTTPS, private network, per-agent key)──► gamm
                                                     ├─ every call written to the audit log
                                                     ├─ read tools ──► Google's google-ads-mcp (unmodified, pinned)
                                                     ├─ write tools ─► Google Ads API
                                                     └─ approval page (passkey)

Why

Google's official google-ads-mcp server is read-only. To manage an account with agents you also need writes, and you need them to be safe:

• One credential. Agents never hold a Google login. Each gets a gamm key that can be revoked on its own.

• Approval that agents can't fake. An agent that controls your browser or shares your network identity still can't produce a passkey assertion with user verification. Approval in chat or in a shared document can be faked.

• Specific write tools, no "change anything" tool. Each change is checked against your rules before you see it.

• One audit trail. Every call is logged with which key, which agent, when and the arguments, and each change keeps its before and after values.

Related MCP server: Google Ads MCP

How a change works

1. Propose. An agent calls propose_change. gamm reads the current values, checks the rules, runs Google's validate-only dry run, and returns an approval link. The approval page shows what will change, worked out by gamm from the live account. The agent's own explanation is shown separately and labeled as the agent's.

2. Approve. You open the link and approve or reject with your passkey. The approval covers that exact version of the change.

3. Apply. The agent calls apply_change. gamm refuses if the approval has expired, a freeze window applies, or the account no longer has the values it had when the change was proposed. Then it writes everything in one atomic request and reads it back.

4. Log and judge. Each change comes with a change_log_row for your own change log, and record_judgement stores how it turned out.

Tools

Google's reference resources (metrics, segments, the API discovery document and release notes) are passed through too.

Changes a proposal can contain:

Asset changes only link and unlink; gamm never deletes an asset. Images aren't supported: they need a person to look at them.

Rules

Set in the settings file. Each is optional.

• min_target_roas: target ROAS is never set below this.

• max_budget_change_pct: the largest budget move in one change.

• max_daily_budget: a ceiling for any campaign's daily budget.

• allowed_url_hosts: the hostnames new sitelinks may link to. gamm loads each new link itself and refuses it unless it ends at HTTP 200 on one of them.

• one_open_change_per: campaign (default) or account. A change touching the whole account, such as account-default conversion goals or account-level sitelinks, blocks every other open change. Asset group changes count against their campaign.

• Freeze windows: date ranges, for the whole account or listed campaigns, in which nothing can be proposed or applied.

• Approvals expire (48 hours by default) and so do unapproved proposals (7 days).

Rules are checked when a change is proposed and again when it is applied.

Running it

gamm is meant to run alone on a small private host reached over a private network such as Tailscale. See docs/deploy.md for a Proxmox LXC setup. You need:

• A Google Cloud project with the Google Ads API enabled and an OAuth client.

• Python 3.12+ and uv.

• An HTTPS address for the approval page (passkeys require it).

Read docs/security.md for what gamm does and doesn't protect against. docs/updating.md covers upgrading Google's server and the Google Ads API version.

Development

uv sync
uv run pytest

See docs/development.md.

License

Apache 2.0. gamm runs Google's google-ads-mcp (also Apache 2.0) as a separate, unmodified program.