Connect the Google Ads API
Integrate the Google Ads API through Modiva’s unified REST API and hosted MCP server. Manage Google Ads search, display and Performance Max campaigns, drill into ad-group, keyword (with Quality Score) and search-term performance, and pull spend, conversion and ROAS reporting through one API. OAuth, token refresh, rate limits and 9 typed tools are handled for you — connect once and call Google Ads from any agent or app through a single endpoint.
What you can do with the Google Ads API
- ✓ Campaign management
- ✓ Reporting
- ✓ Audiences
- ✓ Creative upload
- — Webhooks (Most ad APIs are poll-based)
Google Ads MCP tools & scopes
- campaigns_
- list · create · pause
- adgroups_
- list · analytics
- keywords_
- list · analytics · quality score
- search_terms_
- report · find new keywords & negatives
- analytics_
- spend · conversions · roas
OAuth scopes requested
- Read ad accounts
- Create & manage campaigns
- Read spend & conversion reporting
Connect Google Ads in your agent
# Add Modiva's MCP server to your agent
{
"mcpServers": {
"modiva": {
"url": "https://mcp.modiva.ai",
"headers": { "Authorization": "Bearer $MODIVA_MCP_KEY" }
}
}
}
# Then connect Google Ads and call its tools, e.g.
accounts_list(provider="google-ads")Frequently asked questions
How do I connect the Google Ads API with Modiva?
Create a Modiva account, generate an MCP key, and connect Google Ads from your dashboard. Modiva runs the full OAuth flow and stores the encrypted token for you — no client secrets in your code.
What can I do with the Google Ads API through Modiva?
Manage Google Ads search, display and Performance Max campaigns, drill into ad-group, keyword (with Quality Score) and search-term performance, and pull spend, conversion and ROAS reporting through one API. You get 9 typed tools grouped by resource (campaigns_, adgroups_, keywords_, search_terms_, analytics_), callable over REST or the MCP server.
Do I need to handle OAuth or token refresh myself?
No. Modiva handles the Google Ads OAuth handshake, token storage (envelope-encrypted) and automatic refresh. You call a single unified endpoint.
Can an AI agent use the Google Ads API?
Yes — that is the point. Modiva exposes Google Ads as Model Context Protocol (MCP) tools, so agents like Claude, Cursor or your own app can read and act on Google Ads through one endpoint.
Google Ads playbooks & guides
Free, step-by-step playbooks on growing with Google Ads — what works, plus how to run it with Modiva.