Google Ads Mcp Server

This is not an officially supported Google product.

Google Ads MCP

This is the Google Ads Model Context Protocol (MCP) server designed to provide a standardized way to integrate an LLM with Google Ads.

[](https://github.com/google-marketing-solutions/googleadsmcp_server/actions/workflows/ci.yml) [](https://google.github.io/styleguide/pyguide.html) [](https://conventionalcommits.org) [](https://github.com/pre-commit/pre-commit)

Tools

| Tool | Parameters | Description | | --------------- | ---------------------- | --------------------------------------- | | list_accounts | | Lists all available Google Ads accounts | | search_stream | customer_id, query | Runs a Google Ads query |

To learn more about GAQL, try out the Google Ads Query Builder and ensure you have a valid query.

Setup

Google Ads

Use this documentation to set up a service account for the Google Ads API client library. This will require you to also set up a Google Cloud project and enable the Google Ads API. Create a google-ads.yaml file as defined here. Here's an example:

# google-ads.yaml
developer_token: INSERT_DEVELOPER_TOKEN_HERE
login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE
json_key_file_path: JSON_KEY_FILE_PATH_HERE
use_proto_plus: true

Server

Run the Google Ads MCP server locally:

uv run server

Gemini CLI

Install the Gemini CLI by following the instructions here.

Add the Google Ads MCP server to your ~/.gemini/settings.json file. Here's an example:

{
  "mcpServers": {
    "googleAds": {
      "command": "uv",
      "args": [
        "--directory path/to/google_ads_mcp",
        "run",
        "server"
      ]
    }
  }
}

Learn more about MCP servers and Gemini CLI.

Contributing

Want to contribute? [Learn more](CONTRIBUTING.md)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: google-marketing-solutions
• Source: google-marketing-solutions/googleadsmcp_server
• License: Apache-2.0
• Homepage: https://github.com/googleads/google-ads-mcp

Install and usage instructions live in the source repository linked above.