# Google Ads MCP Server - Mac Setup Guide
## Quick Setup (5 minutes)
### 1. Clone/Copy the Server Files
```bash
# Copy the project to your Mac
# You'll need: server.py, .env, and requirements.txt
```
### 2. Install Dependencies
```bash
cd /path/to/google-ads
pip install google-ads-api mcp
```
### 3. Configure Environment Variables
Copy the template and fill in your credentials:
```bash
cp .env.example .env
```
Then edit `.env` with your Google Ads API credentials from https://developers.google.com/google-ads/api/docs/client-libs/python/configuration
### 4. Add to Claude Desktop
Find or create `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"google-ads": {
"command": "python",
"args": ["/path/to/google-ads/server.py"],
"env": {
"GOOGLE_ADS_DEVELOPER_TOKEN": "your_token",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "your_login_customer_id",
"GOOGLE_ADS_CLIENT_ID": "your_client_id",
"GOOGLE_ADS_CLIENT_SECRET": "your_secret",
"GOOGLE_ADS_REFRESH_TOKEN": "your_refresh_token"
}
}
}
}
```
### 5. Restart Claude Desktop
- Quit Claude completely
- Reopen it
- The Google Ads server should now be available
## Testing
Once running in Claude, try:
- "List my campaigns"
- "What was yesterday's performance?"
- "Show me my ad groups"
- "Execute this GAQL query: SELECT campaign.name, metrics.clicks FROM campaign LIMIT 5"
## Available Methods
- `list_accounts` - List ad accounts
- `list_campaigns` - List campaigns
- `list_ad_groups` - List ad groups
- `list_ads` - List ads
- `list_keywords` - List keywords
- `list_extensions` - List ad extensions
- `list_audiences` - List audiences
- `list_labels` - List labels
- `list_bidding_strategies` - List bidding strategies
- `execute_gaql` - Execute custom GAQL queries
- `get_performance` - Get performance metrics
- `gaql_help` - Get GAQL syntax help
- `search_tools` - Search available tools
## Environment
**Account:** 489-213-0133
**Currency:** GBP (£)
**API Version:** v22
## Troubleshooting
**"Command not found: python"**
- Use `python3` instead, or update the config to use full path: `/usr/local/bin/python3`
**"DEVELOPER_TOKEN invalid"**
- Check the .env file has all 5 credentials set correctly
**"No campaigns found"**
- This is normal - the account may be empty or have no campaigns for the date range
## Support
Refer to:
- `README.md` - Full API documentation
- `GAQL_REFERENCE.md` - Query examples
- `QUICK_START.md` - Common prompts