# Google Ads Mcp Server

> This repo has been archived in favor of: https://github.com/googleads/google-ads-mcp

- **Type:** MCP server
- **Install:** `agentstack add mcp-google-marketing-solutions-google-ads-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [google-marketing-solutions](https://agentstack.voostack.com/s/google-marketing-solutions)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [google-marketing-solutions](https://github.com/google-marketing-solutions)
- **Source:** https://github.com/google-marketing-solutions/google_ads_mcp_server
- **Website:** https://github.com/googleads/google-ads-mcp

## Install

```sh
agentstack add mcp-google-marketing-solutions-google-ads-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

**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/google_ads_mcp_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](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)

## 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](https://github.com/google-marketing-solutions)
- **Source:** [google-marketing-solutions/google_ads_mcp_server](https://github.com/google-marketing-solutions/google_ads_mcp_server)
- **License:** Apache-2.0
- **Homepage:** https://github.com/googleads/google-ads-mcp

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-google-marketing-solutions-google-ads-mcp-server
- Seller: https://agentstack.voostack.com/s/google-marketing-solutions
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.