mcp-google-ads

Name: mcp-google-ads
Author: cohnen

831installs/mo · pypi669stars152forks

How to install mcp-google-ads?

cohnen/mcp-google-ads

$git clone https://github.com/cohnen/mcp-google-ads

Installs into the current project.

Summary

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

Files · 1

View on GitHub

README.md

1	[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cohnen-mcp-google-ads-badge.png)](https://mseep.ai/app/cohnen-mcp-google-ads)
2
3	# Google Ads MCP
4
5	![Google Ads MCP](bg.jpeg)
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

People who liked this also viewed

6 picks

Type

mcp-google-ads

831installs/mo · pypi669stars152forks

View on GitHub

How to install mcp-google-ads?

cohnen/mcp-google-ads

$git clone https://github.com/cohnen/mcp-google-ads

Installs into the current project.

Summary

Files · 1

View on GitHub

README.md

1	[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cohnen-mcp-google-ads-badge.png)](https://mseep.ai/app/cohnen-mcp-google-ads)
2
3	# Google Ads MCP
4
5	![Google Ads MCP](bg.jpeg)
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

People who liked this also viewed

6 picks

Type