Labsco
cohnen logo

Google Ads MCP

★ 656

from cohnen

Manage Google Ads campaigns and reporting using the Google Ads API.

🔥🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup
#email#automation#analytics#e-commerce#cloud#git#maps#marketing

Google Ads MCP

A tool that connects Google Ads 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?

Account Management

  • See all your Google Ads accounts in one place

  • Get account details and basic campaign information

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

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

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

Copy & paste — that's it
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

Copy & paste — that's it
SELECT 
 campaign.name, 
 metrics.clicks, 
 metrics.impressions 
FROM campaign 
WHERE segments.date DURING LAST_7DAYS

Example 2: Ad group performance

Copy & paste — that's it
SELECT 
 ad_group.name, 
 metrics.conversions, 
 metrics.cost_micros 
FROM ad_group 
WHERE metrics.clicks > 100

Example 3: Keyword analysis

Copy & paste — that's it
SELECT 
 keyword.text, 
 metrics.average_position, 
 metrics.ctr 
FROM keyword_view 
ORDER BY metrics.impressions DESC

For a complete list of all available tools and their detailed descriptions, ask Claude to "list tools" after setup.

Data Visualization Capabilities

Claude can help you visualize your Google Ads data in various ways:

  • Trend Charts: See how metrics change over time

  • Comparison Graphs: Compare different campaigns or ad groups

  • Performance Distributions: Understand how your ads perform across devices or audiences

  • Correlation Analysis: Identify relationships between spend and conversion metrics

  • Heatmaps: Visualize complex datasets with color-coded representations

Simply ask Claude to "visualize" or "create a chart" when analyzing your data, and it will generate appropriate visualizations to help you understand the information better.

Contributing

Found a bug or have an idea for improvement? We welcome your input! Open an issue or submit a pull request on GitHub, or contact Ernesto Cohnen directly at [email protected].

License

This project is licensed under the MIT License. See the LICENSE file for details.

About ixigo

ixigo is India's leading travel app, helping millions of travelers find the best deals on flights, trains, buses, and hotels. For more information, visit ixigo.com.

ixigo is a technology company that builds products to help people find the best deals on flights, trains, buses, and hotels. We're a team of travel enthusiasts who are passionate about making travel more affordable and accessible to everyone.