Skip to main content
modiva.ai
Sign In
Google Ads logo

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.

Connect Google Ads — get MCP keyRead the docs

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.

How to Scale Google Ads Campaigns Without Killing Your ROASHow to Build One Ad Reporting Dashboard Across Every Network

Related integrations

Connect Meta AdsConnect TikTok AdsConnect LinkedIn AdsConnect Pinterest AdsConnect X Ads
Connect the Google Ads API — Modiva