mcp-google-ads MCP Server

A tool that connects Google Ads with Claude AI, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics…

Local serverstdio

What is the mcp-google-ads MCP Server?

mcp-google-ads source profile. From the maintainer documentation: “A tool that connects Google Ads with Claude AI, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all through simple chat with Claude.”

Local setup

The project provides a local client configuration using /FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares GOOGLE_ADS_AUTH_TYPE, GOOGLE_ADS_CREDENTIALS_PATH, GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_LOGIN_CUSTOMER_ID. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_accountsShows all your Google Ads accounts
execute_gaql_queryRuns a Google Ads Query Language query
get_campaign_performanceShows campaign metrics with performance data
get_ad_performanceDetailed analysis of your ad creative performance
run_gaqlRuns any arbitrary GAQL query with formatting options

How to install the mcp-google-ads MCP Server

{
  "mcpServers": {
    "googleAdsServer": {
      "command": "/FULL/PATH/TO/mcp-google-ads-main/.venv/bin/python",
      "args": [
        "/FULL/PATH/TO/mcp-google-ads-main/google_ads_server.py"
      ],
      "env": {
        "GOOGLE_ADS_AUTH_TYPE": "oauth",
        "GOOGLE_ADS_CREDENTIALS_PATH": "YOUR_GOOGLE_ADS_CREDENTIALS_PATH",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "YOUR_MANAGER_ACCOUNT_ID_HERE"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GOOGLE_ADS_AUTH_TYPEDeclared in the maintainer’s client configuration.Check documentation
GOOGLE_ADS_CREDENTIALS_PATHDeclared in the maintainer’s client configuration.Check documentation
GOOGLE_ADS_DEVELOPER_TOKENDeclared in the maintainer’s client configuration.Check documentation
GOOGLE_ADS_LOGIN_CUSTOMER_IDDeclared in the maintainer’s client configuration.Optional