mcp-google-ads
bycohnen· 1 MCP server
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—al
How to install mcp-google-ads?
cohnen/mcp-google-ads
$git clone https://github.com/cohnen/mcp-google-adsInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install mcp-google-ads by running `git clone https://github.com/cohnen/mcp-google-ads`, then use it for the current task and follow its documentation at https://github.com/cohnen/mcp-google-ads.
README.md
| 1 | [](https://mseep.ai/app/cohnen-mcp-google-ads) |
| 2 | |
| 3 | # Google Ads MCP |
| 4 | |
| 5 |  |
| 6 | |
| 7 | 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. |
| 8 | |
| 9 | --- |
| 10 | |
| 11 | ## What Can This Tool Do For Advertising Professionals? |
| 12 | |
| 13 | 1. **Account Management** |
| 14 | - See all your Google Ads accounts in one place |
| 15 | - Get account details and basic campaign information |
| 16 | |
| 17 | 2. **Campaign Analytics & Reporting** |
| 18 | - Discover which campaigns are performing best |
| 19 | - Track impressions, clicks, conversions, and cost metrics |
| 20 | - Analyze performance trends over time |
| 21 | - Compare different time periods to spot changes |
| 22 | - **Visualize your data** with charts and graphs created by Claude |
| 23 | |
| 24 | 3. **Keyword & Ad Performance** |
| 25 | - Identify top and underperforming keywords |
| 26 | - Analyze ad copy effectiveness |
| 27 | - Check quality scores and competitive metrics |
| 28 | - Get actionable insights on how to improve your campaigns |
| 29 | |
| 30 | 4. **Budget & Bid Management** |
| 31 | - Monitor campaign budgets and spending |
| 32 | - Analyze bid strategies and performance |
| 33 | - Identify opportunities for optimization |
| 34 | - Get recommendations for budget allocation |
| 35 | |
| 36 | --- |
| 37 | |
| 38 | ## Google Ads MCP Architecture Flow |
| 39 | |
| 40 | ```mermaid |
| 41 | flowchart TB |
| 42 | User(User) -->|Interacts with| Claude |
| 43 | Claude(Claude AI Assistant) -->|Makes requests to| MCP[Google Ads MCP Server] |
| 44 | User -->|Can also use| Cursor[Cursor AI Code Editor] |
| 45 | Cursor -->|Makes requests to| MCP |
| 46 | |
| 47 | subgraph "MCP Server" |
| 48 | FastMCP[FastMCP Server] |
| 49 | Tools[Available Tools] |
| 50 | Auth[Authentication] |
| 51 | |
| 52 | FastMCP -->|Exposes| Tools |
| 53 | FastMCP -->|Uses| Auth |
| 54 | end |
| 55 | |
| 56 | subgraph "Google Ads Tools" |
| 57 | ListAccounts[list_accounts] |
| 58 | ExecuteGAQL[execute_gaql_query] |
| 59 | CampaignPerf[get_campaign_performance] |
| 60 | AdPerf[get_ad_performance] |
| 61 | RunGAQL[run_gaql] |
| 62 | end |
| 63 | |
| 64 | Tools -->|Includes| ListAccounts |
| 65 | Tools -->|Includes| ExecuteGAQL |
| 66 | Tools -->|Includes| CampaignPerf |
| 67 | Tools -->|Includes| AdPerf |
| 68 | Tools -->|Includes| RunGAQL |
| 69 | |
| 70 | subgraph "Authentication" |
| 71 | OAuth[OAuth 2.0 Client ID] |
| 72 | ServiceAccount[Service Account] |
| 73 | Credentials[Google Ads API Credentials] |
| 74 | |
| 75 | OAuth -->|Provides| Credentials |
| 76 | ServiceAccount -->|Provides| Credentials |
| 77 | end |
| 78 | |
| 79 | MCP -->|Communicates with| GoogleAdsAPI[Google Ads API] |
| 80 | GoogleAdsAPI -->|Returns| AdData[Advertising Data] |
| 81 | AdData -->|Analyzed by| Claude |
| 82 | AdData -->|Visualized by| Claude |
| 83 | AdData -->|Can be used by| Cursor |
| 84 | |
| 85 | Credentials -->|Authorizes| GoogleAdsAPI |
| 86 | |
| 87 | subgraph "Configuration" |
| 88 | EnvVars[Environment Variables] |
| 89 | ConfigFiles[Configuration Files] |
| 90 | |
| 91 | EnvVars -->|Configures| MCP |
| 92 | ConfigFiles -->|Configures| Claude |
| 93 | ConfigFiles -->|Configures| Cursor |
| 94 | end |
| 95 | ``` |
| 96 | |
| 97 | ## Available Tools |
| 98 | |
| 99 | Here's what you can ask Claude to do once you've set up this integration: |
| 100 | |
| 101 | | **What You Can Ask For** | **What It Does** | **What You'll Need to Provide** | |
| 102 | |---------------------------------|-------------------------------------------------------------|----------------------------------------------------------------| |
| 103 | | `list_accounts` | Shows all your Google Ads accounts | Nothing - just ask! | |
| 104 | | `execute_gaql_query` | Runs a Google Ads Query Language query | Your account ID and a GAQL query | |
| 105 | | `get_campaign_performance` | Shows campaign metrics with performance data |
Related
6 picksType
- mcp-server-typescriptA Model Context Protocol (MCP) server for the DataForSEO API, enabling modular and extensible integration of DataForSEO endpoints with support for both HTTP and SSE transports.Jul 2026
- dataforseo-mcp-serverA comprehensive stdio MCP server for DataForSEO APIJun 2026
- mcp-gscGoogle Search Console Insights with Claude AI for SEOsJul 2026
- meta-ads-mcpFacebook / Meta Ads automation with AI: analyze performance, test creatives, optimize spend.Jul 2026
- mcp-server-gscEnhanced Model Context Protocol server for Google Search Console with 25K row limit, regex filters, and automatic quick wins detectionFeb 2026
- postmark-mcpOfficial Postmark MCP server for sending emails via Claude and AI assistantsJul 2026
