Google Ads Mcp Server
@gomarble-ai
About Google Ads Mcp Server
A FastMCP-powered Model Context Protocol server for Google Ads API integration with automatic OAuth 2.0 authentication
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"google-ads": {
"command": "/full/path/to/your/project/.venv/bin/python",
"args": [
"/full/path/to/your/project/server.py"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Google Ads MCP Server?
A FastMCP-powered Model Context Protocol server that integrates the Google Ads API with MCP clients like Claude Desktop, featuring automatic OAuth 2.0 authentication, token refresh, GAQL query execution, and keyword research.
How to use Google Ads MCP Server?
Install Python 3.10+, clone the repository, create a virtual environment, install dependencies, configure a .env file with your Google Ads developer token and OAuth credentials path, then add the server to Claude Desktop’s claude_desktop_config.json. After a one-time browser-based OAuth flow, you can issue commands like “List all my Google Ads accounts” or run GAQL queries.
Key features of Google Ads MCP Server
- Automatic OAuth 2.0 with one-time browser authentication
- Smart token management with automatic refresh
- Execute any GAQL query on Google Ads accounts
- List and manage Google Ads accounts
- Generate keyword ideas with search volume data
- Built on FastMCP for modern MCP standards
- Ready for direct integration with Claude Desktop
- Tokens stored locally and never exposed
Use cases of Google Ads MCP Server
- List all accessible Google Ads accounts and identify active campaigns
- Analyze campaign performance, clicks, conversions, and costs with GAQL queries
- Perform keyword research to discover new opportunities with search volume metrics
- Monitor device performance breakdown across campaigns
- Retrieve keyword-level metrics like CTR, average CPC, and quality score
FAQ from Google Ads MCP Server
What does this server do that alternatives don’t?
It provides seamless OAuth 2.0 authentication and automatic token refresh, allowing you to run GAQL queries and keyword research directly from MCP clients without managing authentication manually.
What are the runtime dependencies?
Python 3.10+ is required, along with a Google Cloud Platform project, a Google Ads account with API access, and a developer token (initially a test token, then production access after approval).
Where are authentication tokens stored?
Tokens are stored locally in a google_ads_token.json file in the project directory; credential files are gitignored and never committed to version control.
How does the authentication flow work?
On first use, the server opens your browser to Google’s OAuth page. After you sign in and grant permissions, the token is saved locally and automatically refreshed when needed.
Are there any known limits?
The initial developer token is a test token with limited functionality. Production access requires a separate approval process through the Google Ads API Center.
Frequently asked questions
What does this server do that alternatives don’t?
It provides seamless OAuth 2.0 authentication and automatic token refresh, allowing you to run GAQL queries and keyword research directly from MCP clients without managing authentication manually.
What are the runtime dependencies?
Python 3.10+ is required, along with a Google Cloud Platform project, a Google Ads account with API access, and a developer token (initially a test token, then production access after approval).
Where are authentication tokens stored?
Tokens are stored locally in a `google_ads_token.json` file in the project directory; credential files are gitignored and never committed to version control.
How does the authentication flow work?
On first use, the server opens your browser to Google’s OAuth page. After you sign in and grant permissions, the token is saved locally and automatically refreshed when needed.
Are there any known limits?
The initial developer token is a test token with limited functionality. Production access requires a separate approval process through the Google Ads API Center.
Basic information
More Developer Tools MCP servers
TalkToFigma
sonnylazuardiTalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.
discoverGPT
Joe MonastierodiscoverGPT is visualAI's unified MCP gateway for AI commerce, exposing 29 tools across four capabilities on one canonical product catalog: trimodal search (natural-language, precise-color, and image-similarity), AI cata
MCP Unity Editor (Game Engine)
CoderGamesterModel Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs
PuzzleTide Puzzle Generator
Caravaca-LabsWord search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers
Sentry
modelcontextprotocolModel Context Protocol Servers
Comments