Google Ads MCP logo

Google Ads MCP

by cohnen

Google Ads MCP connects Google Ads with Claude AI, enabling natural language analysis of advertising data. It provides access to campaign information, performance metrics, and ad management through simple chat.

View on GitHub

Last updated: N/A

What is Google Ads MCP?

Google Ads MCP is a tool that integrates Google Ads with Claude AI, allowing users to analyze their advertising data through natural language conversations. It acts as a server that exposes Google Ads tools to Claude and Cursor AI Code Editor.

How to use Google Ads MCP?

To use Google Ads MCP, you need to set up Google Ads API access, install required software (Python, Node.js, Claude Desktop/Cursor), download the tool, install dependencies, configure environment variables, and connect Claude/Cursor to the server. Once set up, you can ask Claude/Cursor questions about your Google Ads data using provided tools like list_accounts, execute_gaql_query, get_campaign_performance, get_ad_performance, and run_gaql.

Key features of Google Ads MCP

  • Account Management: See all your Google Ads accounts in one place.

  • Campaign Analytics & Reporting: Track and analyze campaign performance with visualizations.

  • Keyword & Ad Performance: Identify top and underperforming keywords and ads.

  • Budget & Bid Management: Monitor budgets and optimize bid strategies.

Use cases of Google Ads MCP

  • Analyzing campaign performance trends over time.

  • Identifying opportunities for budget optimization.

  • Generating reports on ad copy effectiveness.

  • Automating Google Ads data analysis with AI.

FAQ from Google Ads MCP

What authentication methods are supported?

OAuth 2.0 Client ID (User Authentication) and Service Account (Server-to-Server Authentication).

What is a Google Ads Developer Token and how do I get one?

A Developer Token allows access to the Google Ads API. You can obtain one by signing into your Google Ads account, navigating to Tools & Settings -> API Center, and applying for a token.

What is the purpose of the GOOGLE_ADS_LOGIN_CUSTOMER_ID?

It's used when working with a Google Ads Manager Account (MCC) to access multiple client accounts under that manager account.

What do I do if I get a 'pip not found' error?

Ensure pip is installed and updated by running python3 -m ensurepip --upgrade and python3 -m pip install --upgrade pip.

How do I test if my Google Ads API connection is working correctly?

Run the test_google_ads_mcp.py file in the repository after configuring the environment variables.