mcp-google-ads

[](https://mseep.ai/app/cohnen-mcp-google-ads) # Google Ads MCP  A tool that connects [Google Ads](https://ads.google.com/) with Claude AI, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all through simple chat with Claude. --- ## What Can This Tool Do For Advertising Professionals? 1. **Account Management** - See all your Google Ads accounts in one place - Get account details and basic campaign information 2. **Campaign Analytics & Reporting** - Discover which campaigns are performing best - Track impressions, clicks, conversions, and cost metrics - Analyze performance trends over time - Compare different time periods to spot changes - **Visualize your data** with charts and graphs created by Claude 3. **Keyword & Ad Performance** - Identify top and underperforming keywords - Analyze ad copy effectiveness - Check quality scores and competitive metrics - Get actionable insights on how to improve your campaigns 4. **Budget & Bid Management** - Monitor campaign budgets and spending - Analyze bid strategies and performance - Identify opportunities for optimization - Get recommendations for budget allocation --- ## Google Ads MCP Architecture Flow ```mermaid flowchart TB User(User) -->|Interacts with| Claude Claude(Claude AI Assistant) -->|Makes requests to| MCP[Google Ads MCP Server] User -->|Can also use| Cursor[Cursor AI Code Editor] Cursor -->|Makes requests to| MCP subgraph "MCP Server" FastMCP[FastMCP Server] Tools[Available Tools] Auth[Authentication] FastMCP -->|Exposes| Tools FastMCP -->|Uses| Auth end subgraph "Google Ads Tools" ListAccounts[list_accounts] ExecuteGAQL[execute_gaql_query] CampaignPerf[get_campaign_performance] AdPerf[get_ad_performance] RunGAQL[run_gaql] end Tools -->|Includes| ListAccounts Tools -->|Includes| ExecuteGAQL Tools -->|Includes| CampaignPerf Tools -->|Includes| AdPerf Tools -->|Includes| RunGAQL subgraph "Authentication" OAuth[OAuth 2.0 Client ID] ServiceAccount[Service Account] Credentials[Google Ads API Credentials] OAuth -->|Provides| Credentials ServiceAccount -->|Provides| Credentials end MCP -->|Communicates with| GoogleAdsAPI[Google Ads API] GoogleAdsAPI -->|Returns| AdData[Advertising Data] AdData -->|Analyzed by| Claude AdData -->|Visualized by| Claude AdData -->|Can be used by| Cursor Credentials -->|Authorizes| GoogleAdsAPI subgraph "Configuration" EnvVars[Environment Variables] ConfigFiles[Configuration Files] EnvVars -->|Configures| MCP ConfigFiles -->|Configures| Claude ConfigFiles -->|Configures| Cursor end ``` ## Available Tools Here's what you can ask Claude to do once you've set up this integration: | **What You Can Ask For** | **What It Does** | **What You'll Need to Provide** | |---------------------------------|-------------------------------------------------------------|----------------------------------------------------------------| | `list_accounts` | Shows all your Google Ads accounts | Nothing - just ask! | | `execute_gaql_query` | Runs a Google Ads Query Language query | Your account ID and a GAQL query | | `get_campaign_performance` | Shows campaign metrics with performance data | Your account ID and time period | | `get_ad_performance` | Detailed analysis of your ad creative performance | Your account ID and time period | | `run_gaql` | Runs any arbitrary GAQL query with formatting options | Your account ID, query, and format (table, JSON, or CSV) | ### Using the Advanced Query Tools The `run_gaql` tool is especially powerful as it allows you to run any custom Google Ads Query Language (GAQL) query. Here are some example queries you can use: ### Example 1: Basic campaign metrics ```sql SELECT campaign.name, metrics.clicks, metrics.impressions FROM campaign WHERE segments.date DURING LAST_7DAYS ``` ### Example 2: Ad group performance ```sql SELECT ad_group.name, metrics.conversions, metrics.cost_micros FROM ad_group WHERE metrics.clicks > 100 ``` ### Example 3: Keyword analysis ```sql SELECT