https://github.com/google-marketing-solutions/google_ads_mcp_server

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/google_ads_mcp_server

ads claude code context fastmcp gemini google googleads llm mcp

Last synced: 9 months ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/google-marketing-solutions/google_ads_mcp_server
• Owner: google-marketing-solutions
• License: apache-2.0
• Created: 2025-07-24T16:16:47.000Z (11 months ago)
• Default Branch: main
• Last Pushed: 2025-08-29T04:26:36.000Z (10 months ago)
• Last Synced: 2025-08-29T08:30:10.438Z (9 months ago)
• Topics: ads, claude, code, context, fastmcp, gemini, google, googleads, llm, mcp
• Language: Python
• Homepage:
• Size: 154 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
**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.

[![Continuous Integration](https://github.com/google-marketing-solutions/google_ads_mcp_server/actions/workflows/ci.yml/badge.svg)](https://github.com/google-marketing-solutions/google_ads_mcp_server/actions/workflows/ci.yml)

[![Code Style: Google](https://img.shields.io/badge/code%20style-google-4285F4.svg)](https://google.github.io/styleguide/pyguide.html)

[![Conventional Commits](https://img.shields.io/badge/conventional%20commits-1.0.0-fe5196.svg?logo=conventionalcommits)](https://conventionalcommits.org)

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](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](https://developers.google.com/google-ads/api/fields/v20/query_validator)

and ensure you have a valid query.

## Setup

### Google Ads

Use

[this documentation](https://developers.google.com/google-ads/api/docs/oauth/service-accounts)

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](https://github.com/googleads/google-ads-python/blob/HEAD/google-ads.yaml).

Here's an example:

```yaml

# 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:

```shell

uv run server

```

### Gemini CLI

Install the Gemini CLI by following the instructions

[here](https://github.com/google-gemini/gemini-cli).

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

example:

```json

{

  "mcpServers": {

    "googleAds": {

      "command": "uv",

      "args": [

        "--directory path/to/google_ads_mcp",

        "run",

        "server"

      ]

    }

  }

}

```

Learn more about

[MCP servers and Gemini CLI](https://cloud.google.com/gemini/docs/codeassist/use-agentic-chat-pair-programmer#configure-mcp-servers).

## Contributing

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