Which integrations are available for this server?

Allows interaction with the Google Ads API, enabling AI agents to manage campaigns, ad groups, ads, and execute GAQL queries for reporting and data retrieval.

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@gads list my accessible customers" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

gads

by n-asuy

Overview Schema Related Servers Score Discussions

Rust

Remote

gads

A Google Ads API MCP server & CLI written in Rust.

Calls the Google Ads REST API (v21) directly via reqwest — no gRPC dependency. Inspired by googleads/gads (Python).

Security Notice

gads authenticates through Google Cloud Application Default Credentials (ADC). Once you run gcloud auth application-default login, the resulting credential file (~/.config/gcloud/application_default_credentials.json) is a machine-wide, long-lived OAuth2 refresh token. Any process on your machine — not just gads — can read this file and obtain access tokens for every scope you authorized, including the Google Ads API and any other Google Cloud APIs.

Use gads at your own risk. You are responsible for securing your local credentials and understanding the implications of ADC-based authentication.

See Roadmap for planned mitigations.

Related MCP server: Discovery Engine MCP Server

Setup

1. Google Cloud Project

# Install gcloud CLI if needed
# https://cloud.google.com/sdk/docs/install

gcloud auth login
gcloud config set project YOUR_PROJECT_ID

2. Enable the Google Ads API

gcloud services enable googleads.googleapis.com

Or enable via Cloud Console.

3. Obtain a Developer Token

Sign in to Google Ads
Tools & Settings > Setup > API Center
Copy the developer token (initial access is test-account only; production requires approval)

Details: https://developers.google.com/google-ads/api/docs/get-started/dev-token

4. Authentication

Option A: Application Default Credentials (recommended)

gcloud auth application-default login \
  --scopes="https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/adwords"

This creates ~/.config/gcloud/application_default_credentials.json, which gads discovers automatically.

Option B: Service Account

gcloud iam service-accounts create gads-sa \
  --display-name="gads service account"

gcloud iam service-accounts keys create sa-key.json \
  --iam-account=gads-sa@YOUR_PROJECT_ID.iam.gserviceaccount.com

export GOOGLE_APPLICATION_CREDENTIALS=/path/to/sa-key.json

You must also invite the service account email in Google Ads: Tools & Settings > Access & Security > add the service account email.

5. Environment Variables

export GOOGLE_ADS_DEVELOPER_TOKEN="your-developer-token"

# Required only when accessing accounts via an MCC (Manager account)
export GOOGLE_ADS_LOGIN_CUSTOMER_ID="1234567890"

# Quota project for ADC user credentials (prevents 403)
export GOOGLE_CLOUD_QUOTA_PROJECT="your-gcp-project-id"

Variable	Required	Description
`GOOGLE_ADS_DEVELOPER_TOKEN`	Yes	Google Ads API developer token
`GOOGLE_ADS_LOGIN_CUSTOMER_ID`	No	MCC customer ID (no hyphens)
`GOOGLE_CLOUD_QUOTA_PROJECT`	No	Sets `x-goog-user-project` header for ADC user credentials
`GOOGLE_APPLICATION_CREDENTIALS`	No	Path to service account JSON key. Falls back to ADC auto-discovery

6. Verify

cargo build -p gads --release

# List accessible accounts to confirm authentication
gads customers

Build

# Build host binary + npx tgz
bun run build

Release

# Patch version bump + build + publish
bun run release

CLI Usage

Running without arguments (or with serve) starts the MCP server. Subcommands invoke the API directly.

gads [COMMAND]

Commands:
  serve      Start MCP server (stdio transport) [default]
  login      Authenticate via gcloud ADC with Google Ads API scope
  doctor     Diagnose auth, config, and API connectivity
  customers  List accessible customers with MCC/ACCOUNT labels
  use        Save/show default customer ID
  search     Execute a GAQL query
  campaign   Campaign operations (list / status)
  adgroup    Ad group operations (list / status)
  ad         Ad operations (list / status)
  creatives  List ad creatives (headlines, descriptions, URLs)
  mutate     Execute arbitrary mutate requests (create/update/delete)
  config     Manage persistent config (developer-token, login-customer-id)

customers

gads customers
gads customers --tree
gads customers --ids-only

doctor

gads doctor

search

# Save a default customer ID first (optional)
gads use 1234567890

# Raw GAQL
gads search \
  -q "SELECT campaign.id, campaign.name FROM campaign" \
  -l 10

# Override login-customer-id for this command only
gads search \
  --customer-id 1234567890 \
  --login-customer-id 9988776655 \
  -q "SELECT campaign.id, campaign.name FROM campaign"

# Disable login-customer-id for this command
gads search \
  --customer-id 1234567890 \
  --no-login-customer-id \
  -q "SELECT campaign.id, campaign.name FROM campaign"

# Shorthand: resource + fields
gads search \
  --customer-id 1234567890 \
  -q "campaign campaign.id,campaign.name" \
  -l 10

Output is a JSON array. Pipe to jq:

gads search -c 1234567890 -q "SELECT campaign.name FROM campaign" | jq '.[].["campaign.name"]'

use

gads use 1234567890   # save default customer ID
gads use              # show current default

campaign / adgroup / ad / creatives

gads campaign list -l 100
gads adgroup list -l 200
gads ad list -l 200
gads creatives -l 200

# Disable MCC header for this command
gads campaign --no-login-customer-id list

Status updates (ENABLED / PAUSED)

gads campaign status --campaign-id 123456789 --status ENABLED
gads adgroup status --ad-group-id 987654321 --status PAUSED
gads ad status --ad-group-id 987654321 --ad-id 1122334455 --status ENABLED

# Validate only (dry run)
gads campaign status --campaign-id 123456789 --status ENABLED --validate-only

mutate

Calls customers/{customer_id}/{service}:mutate directly. Supports any create/update/delete operation.

# Inline JSON
gads mutate \
  --service campaigns \
  --body '{
    "operations": [{
      "update": {
        "resourceName": "customers/1234567890/campaigns/111222333",
        "status": "ENABLED"
      },
      "updateMask": "status"
    }]
  }'

# From file + validate only
gads mutate \
  --service adGroupAds \
  --body-file ./mutate-body.json \
  --validate-only

MCP Server Usage

Claude Desktop / Claude Code

{
  "mcpServers": {
    "gads": {
      "command": "/path/to/gads",
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "1234567890"
      }
    }
  }
}

MCP Tools

Tool	Description
`search`	Execute GAQL queries against Google Ads. Includes embedded field reference for all v21 resources
`list_accessible_customers`	List customer IDs accessible by the authenticated user

Architecture

src/
  main.rs      — Entry point (CLI parser + MCP serve)
  server.rs    — MCP tool registration + ServerHandler
  client.rs    — Google Ads REST API client
  auth.rs      — ADC token acquisition via gcp_auth
  query.rs     — GAQL query builder
  format.rs    — searchStream response flattening
  error.rs     — Unified error type
  gaql_resources.json — GAQL v21 field reference (compile-time embed)

Test

cargo test -p gads

Roadmap

Scoped credential isolation — Current ADC credentials grant access to all authorized scopes machine-wide. Investigate per-tool credential isolation (e.g., short-lived tokens with scope restricted to adwords only, or a proxy that mediates token exchange) so that a compromised process cannot leverage gads credentials for unrelated GCP APIs.
Token broker / proxy architecture — Instead of reading ADC directly, gads could request tokens from a local broker that enforces scope, audience, and lifetime constraints. This would prevent other processes from reusing the raw refresh token.
Credential storage hardening — Explore alternatives to the plaintext ADC JSON file (e.g., OS keychain integration, encrypted-at-rest profiles).
Audit logging — Log all API calls with timestamps and caller context to detect unauthorized usage of shared credentials.

License

MIT

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

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/n-asuy/gads'

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