google-ads-mcp-js

Google Ads MCP (Node.js) - by TrueClicks

Google Ads MCP by TrueClicks enables your AI (like Claude) to securely access and query your Google Ads account data. It supports both Windows and macOS, including Intel and ARM-based systems. It connects AIs to Google Ads using [GAQL.app] as a backend.

This is an unofficial Google Ads MCP integration - and as of now, no official version exists.

---

✅ Why Use This MCP?

Unlike other open-source Multi-Client Processors (MCPs) for Google Ads, this Node.js-based MCP offers the easiest setup experience available:

• 🟢 No Google Cloud Project setup required
• 🟢 No OAuth credentials
• 🟢 No Developer Tokens
• 🟢 No Client IDs
• 🟢 No authentication hassles

Instead, it uses free GAQL.app, which securely handles authentication and query execution behind the scenes.

This makes it ideal for users who want to get up and running within minutes.

---

🛠️ Setup Guide

1. Install Node.js

Ensure you have Node.js installed on your system.

• On Windows, open Command Prompt (search for "cmd" in the Start menu) and run:

winget install nodejs

• On macOS, download and install Node.js from https://nodejs.org. If you need help, please refer to the screenshots at the end of this document.

2. Get Your GPT Token

1. Go to https://gaql.app
2. Log in using your Google account to authorize Google Ads access.
3. Click the Copy GPT Token button in the top-right corner.

3. Configure Your AI (Claude)

The application is configured via a JSON file named claude_desktop_config.json.

1. Open the Claude desktop application.

2. Press:

   • CTRL + , (Control key and comma) on Windows/Linux
   • Command + , (Command key and comma) on macOS

3. In the left sidebar, click Developer.

4. Open  Edit config and open claude_desktop_config.json for editing.

5. Paste the following JSON into your configuration file:

   {
     "mcpServers": {
       "gads": {
         "command": "npx",
         "args": [
           "-y",
           "@trueclicks/google-ads-mcp-js",
           "--token=YOUR_GPT_TOKEN_HERE"
         ]
       }
     }
   }
   

   Important: Replace YOUR_GPT_TOKEN_HERE with the token copied from GAQL.app.

6. Exit Claude completely:

   • On Windows/Linux: Hamburger menu > File > Exit
   • On macOS: Right-click the Claude icon in the top-right panel and click Quit

7. Restart Claude.

You’re now ready to use Claude AI to query your Google Ads accounts.

---

💬 Example Prompts

• List my Google Ads accounts
• What is the cost for account XYZ in the past 30 days?
• What are the top 5 setting recommendations for my campaigns?

---

🆚 Comparison with Other Google Ads MCPs

Feature	Google Ads MCP (Node.js)	Other MCPs (Python/etc.)
Google Cloud project setup	🟢 No	🔧 Yes
OAuth Client ID required	🟢 No	🔧 Yes
Developer Token needed	🟢 No	🔧 Yes
Google Ads API familiarity	🟢 No	⚠️ Yes
Setup complexity	🎉 Very low	🟠 Moderate to high
Backend service	☁️ Hosted via GAQL.app	🔧 Direct API integration

---

📸 Setup Screenshots (macOS)

1. Node.js download: Screenshot of downloading Node.js from the official site.

2. Claude Developer section: Screenshot of accessing the Developer section in Claude.

3. Open configuration file for editing: Screenshot showing how to open claude_desktop_config.json.

4. Editing configuration JSON: Screenshot of the JSON configuration being edited.

5. Restarting Claude: Screenshot showing how to quit and restart Claude from the top-right corner.

6. Example prompt: Screenshot showing an example prompt using Claude with Google Ads integration.

---

For issues or questions, please contact ales@trueclicks.com.

---