google_ads_mcp

Overview

The Google Ads MCP Server provides a bridge between large language models and Google's advertising platform. It implements the MCP protocol to allow LLMs like Gemini to query campaign data, manage ad groups, and perform various advertising operations. While currently experimental and not officially supported by Google, it offers both read-only access to GAQL data and optional mutation capabilities for modifying campaigns, budgets, and ads when properly configured.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• execute_gaql

  Query Google Ads data using GAQL.

  Try:list all campaignsTry:show me metrics for campaign [CAMPAIGN_ID]Try:get all ad groups
• list_accounts

  List accessible Google Ads accounts.

  Try:show my accountsTry:list accessible accountsTry:get account information
• get_gaql_documentation

  Access documentation for GAQL.

  Try:show GAQL documentationTry:how do I write a GAQL queryTry:GAQL syntax
• create_campaign_budget

  Create a new campaign budget.

  Try:create campaign budget with $100Try:add budget to campaignTry:set new budget
• create_campaign

  Create a new campaign.

  Try:create a new search campaignTry:add campaign for summer saleTry:launch new campaign
• create_ad_group

  Create a new ad group.

  Try:create ad group for keywordsTry:add new ad groupTry:make ad group
• create_ad

  Create a new ad.

  Try:create responsive search adTry:add new ad to campaignTry:make ad
• create_criteria

  Create new criteria (e.g., keywords).

  Try:add keyword 'shoes'Try:create new criteriaTry:add negative keyword

Comparable tools

Installation

pipx run --spec git+https://github.com/google-marketing-solutions/google_ads_mcp.git run-mcp-server

uv pip sync
uv run -m ads_mcp.server

{
  "mcpServers": {
    "GoogleAds": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/google-marketing-solutions/google_ads_mcp.git",
        "run-mcp-server"
      ],
      "env": {
        "GOOGLE_ADS_CREDENTIALS": "PATH_TO_YAML"
      },
      "timeout": 30000
    }
  }
}

FAQ

Is this officially supported by Google?

No, this is NOT an officially supported Google product. It's mainly for experimental purposes.

What are the system requirements?

Python 3.12 with either pipx or uv for dependency management. Requires valid Google Ads API credentials.

Compare google_ads_mcp with