# Google Ads MCP

**Repo:** https://github.com/ram-amit/google-ads-mcp

MCP server for querying monday.com's Google Ads accounts from **Cursor**, **Claude Code**, or **Claude Desktop**.

## Prerequisites

| Requirement | Notes |
|-------------|--------|
| **Cursor**, **Claude Code**, or **Claude Desktop** | Not monday browser Claude |
| **Python 3.10+** | Installer can auto-install via `uv` if needed |
| **@monday.com Google account** | With access to the relevant Ads accounts |

## Install (new users)

```bash
git clone https://github.com/ram-amit/google-ads-mcp.git ~/google-ads-mcp
cd ~/google-ads-mcp
xattr -dr com.apple.quarantine . 2>/dev/null || true
bash install/install.sh
```

Or double-click `Install Google Ads MCP.command` after cloning.

Full team instructions: [install/README.md](install/README.md)

**Maintainers:** copy `install/shared_credentials.env.example` to `install/shared_credentials.env` before building a team zip (`bash install/package.sh`). That file is gitignored and not pushed to GitHub.

## Update (existing users)

```bash
cd ~/google-ads-mcp
git pull origin main
```

Then fully quit and reopen Claude (Cmd+Q).

Or replace only `server.py` via [UPDATE.md](UPDATE.md).

## Tools

| Tool | Use for |
|------|---------|
| `list_accounts` | See all reachable accounts under the MCC |
| `list_campaigns` | Campaign list with status, budget, bid strategy |
| `get_campaign_performance` | Performance metrics by campaign |
| `get_bid_changes` | Bid strategy change history |
| `run_query` | Interactive GAQL queries (client-side row cap) |
| `export_to_csv` | Full large exports to `~/Downloads/google-ads-exports/` |

## Changelog

See [CHANGELOG.md](CHANGELOG.md).