Google Ads MCP

Local install

com.renzojohnson/google-ads-mcpv26.11.13 Domain verified

Google Ads MCP server: GAQL queries, performance reports and campaign management.

Marketing & SEO

Watch Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-12T23:47:26.678505Z",
      "publishedAt": "2026-11-12T23:47:26.678505Z",
      "statusChangedAt": "2026-11-12T23:47:26.678505Z"
    }
  },
  "server": {
    "name": "com.renzojohnson/google-ads-mcp",
    "title": "Google Ads MCP",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "26.11.13",
    "packages": [
      {
        "version": "26.11.13",
        "transport": {
          "type": "stdio"
        },
        "identifier": "@renzo.johnson/google-ads-mcp",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "GOOGLE_ADS_DEVELOPER_TOKEN",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "Google Ads API developer token."
          },
          {
            "name": "GOOGLE_OAUTH_CLIENT_ID",
            "format": "string",
            "isRequired": true,
            "description": "OAuth client ID. Set together with the client secret and refresh token."
          },
          {
            "name": "GOOGLE_OAUTH_CLIENT_SECRET",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "OAuth client secret."
          },
          {
            "name": "GOOGLE_OAUTH_REFRESH_TOKEN",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "OAuth refresh token with the Google Ads scope."
          },
          {
            "name": "GOOGLE_ADS_LOGIN_CUSTOMER_ID",
            "format": "string",
            "description": "Manager (MCC) account ID, digits only, when you access accounts through a manager."
          },
          {
            "name": "GOOGLE_ADS_DEFAULT_CUSTOMER_ID",
            "format": "string",
            "description": "Account used when a tool call names none."
          }
        ]
      }
    ],
    "websiteUrl": "https://renzojohnson.com/contributions/google-ads-mcp",
    "description": "Google Ads MCP server: GAQL queries, performance reports and campaign management."
  }
}

Maintain this server? Claim it

Try it

This server only runs locally, from a package. Install it with the instructions on this page to try it.

Install

Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.

One click: Add to Cursor Add to VS Code Add to LM StudioThen replace the YOUR_ values and {placeholders} with your own.

Run in a terminal

claude mcp add google-ads-mcp \
  -e GOOGLE_ADS_DEVELOPER_TOKEN=YOUR_GOOGLE_ADS_DEVELOPER_TOKEN \
  -e GOOGLE_OAUTH_CLIENT_ID=YOUR_GOOGLE_OAUTH_CLIENT_ID \
  -e GOOGLE_OAUTH_CLIENT_SECRET=YOUR_GOOGLE_OAUTH_CLIENT_SECRET \
  -e GOOGLE_OAUTH_REFRESH_TOKEN=YOUR_GOOGLE_OAUTH_REFRESH_TOKEN \
  -- npx -y @renzo.johnson/[email protected]

Environment

GOOGLE_ADS_DEVELOPER_TOKEN (required): Google Ads API developer token.
GOOGLE_OAUTH_CLIENT_ID (required): OAuth client ID. Set together with the client secret and refresh token.
GOOGLE_OAUTH_CLIENT_SECRET (required): OAuth client secret.
GOOGLE_OAUTH_REFRESH_TOKEN (required): OAuth refresh token with the Google Ads scope.
GOOGLE_ADS_LOGIN_CUSTOMER_ID (optional, not in the config above): Manager (MCC) account ID, digits only, when you access accounts through a manager.
GOOGLE_ADS_DEFAULT_CUSTOMER_ID (optional, not in the config above): Account used when a tool call names none.

Tools

We don't run packages, so we can't list this server's tools.