Skip to main content
Glama
Sign In
Google Ads MCP

Google Ads MCP

by iammalekk
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

Google Ads MCP

An MCP server that lets an AI assistant (Devin, Claude Desktop, Cursor, …) read and change your Google Ads account: run reports, create and edit campaigns, budgets, ad groups, keywords, ads and conversion actions.

It uses the Google Ads REST API (v26) with your own Google OAuth client and developer token. Credentials stay on your machine in ~/.google-ads-mcp/config.json.

Safety defaults

  • New campaigns and ads are created PAUSED, so nothing spends money until you enable it.

  • Every tool that makes changes accepts validateOnly: true, which checks the change without applying it.

  • Budgets and bids are entered in account currency (e.g. 20 = 20.00/day) and converted to micros for you.

Related MCP server: Google Ads MCP

Tools

Tool

Actions

gads_customer

list_accessible, get, list_clients (MCC child accounts)

gads_query

Run any GAQL query (auto-paginated)

gads_report

Performance at account / campaign / ad_group / keyword / search_term / ad level

gads_budget

list, create, update, remove

gads_campaign

list, create (Search campaign + budget in one step), update, pause, enable, remove

gads_ad_group

list, create, update, pause, enable, remove

gads_keyword

list, add, add_negative, remove_negative, update, pause, enable, remove

gads_ad

list, create_rsa (Responsive Search Ad), update, pause, enable, remove

gads_conversion_action

list, create, update, remove, gtm_tag (Conversion ID + Label for a GTM Google Ads conversion tag)

gads_keyword_ideas

Keyword Planner ideas: search volume, competition, bid ranges

gads_mutate

Any combination of GoogleAdsService MutateOperations, applied atomically

gads_raw

Call any Google Ads REST endpoint directly

Setup

1. Google Cloud OAuth client (one-time)

  1. Enable the Google Ads API: https://console.cloud.google.com/apis/library/googleads.googleapis.com

  2. OAuth consent screen: https://console.cloud.google.com/apis/credentials/consent — User type External, then add your Google email under Test users.

  3. Credentials: https://console.cloud.google.com/apis/credentials, then Create credentials → OAuth client ID → Desktop app. Copy the Client ID and Client secret.

2. Google Ads developer token

In a Google Ads manager (MCC) account: Tools → API Center. A new token starts at Test access, which only works with test accounts. Apply for Basic access to use it on real accounts.

3. Sign in

npx -y github:iammalekk/google-ads-mcp auth

Paste the client ID, client secret and developer token. Optionally add your MCC customer ID (if you reach accounts through a manager) and a default customer ID. A browser window opens for Google sign-in.

4. Add it to your MCP client

{
  "mcpServers": {
    "Google Ads MCP": {
      "command": "npx",
      "args": ["-y", "github:iammalekk/google-ads-mcp"]
    }
  }
}

Restart the client, then ask: "List my Google Ads accounts".

Other commands

npx -y github:iammalekk/google-ads-mcp status   # show saved config
npx -y github:iammalekk/google-ads-mcp logout   # delete saved credentials

Environment overrides

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN, GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID, GOOGLE_ADS_CUSTOMER_ID, GOOGLE_ADS_API_VERSION (default v26).

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Google Ads MCP Server (Fork

      mathiaschu
      A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to manage Google Ads accounts by providing tools for querying account data and performing write operations such as updating campaign budgets, statuses, and bidding strategies.
      2
      Apache 2.0

    • Google Ads MCP

      LucasSantana-Dev
      A
      license
      A
      quality
      F
      maintenance
      Enables managing Google Ads campaigns through an AI assistant with read-only reporting, recommendations, and gated write operations for bids, budgets, and statuses, all backed by preview and audit logging.
      31
      1
      MIT

    • Google Ads MCP Server

      FlatbuzhZubumafu
      A
      license
      B
      quality
      C
      maintenance
      Enables Claude and other MCP-capable assistants to monitor and manage Google Ads accounts by pulling performance reports, running GAQL queries, adjusting budgets, pausing or enabling campaigns, adding keywords and negative keywords, and creating campaigns and ads, with preview and read-only safety controls.
      31
      Apache 2.0

    • google-ads-mcp

      kevin-namba
      A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients such as Claude to read Google Ads performance reports, run keyword planner queries, and create or manage search and Performance Max campaigns, ad groups, keywords, ads, budgets, and delivery status. Write operations default to paused and can be disabled entirely for read-only analytics use.
      16
      MIT