Skip to main content
Glama
apexradius

mcp-google-ads

by apexradius
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

mcp-google-ads

Multi-account Google Ads MCP server for operators who need one MCP surface across multiple client or in-house ad accounts without restarting the server.

Release posture: beta package, version 0.1.0 from pyproject.toml.

Choose your path

You are...

Start here

Then

Connecting the server to your MCP client

docs/start-here.md

Quick start below

Auditing account switching and retries

docs/architecture.md

gads/server.py

Reviewing packaging metadata

pyproject.toml

accounts.example.json

Related MCP server: google-ads-mcp

Architecture

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> S[FastMCP server]
  S --> M[Account manager]
  M --> F[Accounts config]
  S --> Q[GAQL query helpers]
  Q --> R[Retry wrapper]
  R --> A[Google Ads API]
  A --> R --> S

Request flow

flowchart TD
  P[Operator asks for account or campaign data] --> T[Selected MCP tool]
  T --> A[Resolve named or default account]
  A --> B[Build Google Ads client]
  B --> C[Run GAQL query]
  C --> D{API call succeeds?}
  D -- yes --> E[Normalize rows and return]
  D -- retryable --> F[Backoff and retry]
  F --> D
  D -- no --> G[Return error payload]

Quick start

  1. Install the package.

python -m pip install mcp-google-ads-multi

  1. Copy the accounts config template and add your accounts.

mkdir -p ~/.config/mcp-google-ads
cp accounts.example.json ~/.config/mcp-google-ads/accounts.json

  1. Register it in your MCP client.

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": ["mcp-google-ads-multi"],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token",
        "GOOGLE_ADS_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-google-ads/accounts.json"
      }
    }
  }
}

Available tools

Tool group

Tools

Purpose

Account selection

list_accounts, set_default_account, list_customers

Manage account routing and discover accessible customers

Spend summary

get_account_summary, compare_periods

Period-over-period account reporting

Campaign analysis

list_campaigns, get_campaign_performance

Campaign inventory and range-based metrics

Query-level detail

get_keyword_performance, search_terms_report, get_ad_performance

Keyword, search-term, and ad reporting

Runtime proof

Claim

Proof

Package entry point is stable

mcp-google-ads-multi = "gads.server:main" in pyproject.toml

Multi-account routing is first-class

AccountManager() and set_default_account() in gads/server.py

Queries go through reusable helpers

gads/query.py and gads/retry.py

Config is file-driven

accounts.example.json documents the accounts shape

Repo map

Path

Purpose

gads/server.py

FastMCP tool surface

gads/accounts.py

Account config, OAuth/service-account loading

gads/query.py

GAQL execution helpers

gads/retry.py

Retry behavior for API calls

docs/start-here.md

Setup, validation, common failures

docs/architecture.md

Component map and request lifecycle

Validation

Check

Command

Import compiles

python -m compileall gads

Package builds

python -m build

README/docs links are local

rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

License

MIT

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • google-ads-mcp by googleads

    google-ads-mcpofficial

    googleads
    A
    license
    -
    quality
    B
    maintenance
    MCP server that provides tools and resources for interacting with Google Ads API, enabling search, metadata retrieval, and account management through natural language.
    Last updated
    732
    Apache 2.0

  • google-ads-mcp

    aisandler
    A
    license
    -
    quality
    D
    maintenance
    MCP server for Google Ads campaign reporting and management via Claude, enabling GAQL queries, performance metrics, and campaign modifications.
    Last updated
    28
    MIT

  • mcp-search-console

    apexradius
    A
    license
    A
    quality
    B
    maintenance
    Multi-account Google Search Console MCP server enabling AI assistants to query multiple GSC accounts by name in a single session, with support for OAuth and service accounts.
    Last updated
    17
    MIT

View all related MCP servers

Related MCP Connectors

  • mcp-serp

    MCP server for Google search results via SERP API

  • agentcentral

    Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.

  • GTM API: LinkedIn MCP Server

    Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/apexradius/mcp-google-ads'

If you have feedback or need assistance with the MCP directory API, please join our Discord server