Adloop Google Ads Control

v1.0.0Marketing & SEOstable

The AI command center for Google Ads, GA4, and tracking code.

aicursorga4google-adsgoogle-analytics
Share:
161
Stars
0
Downloads
0
Weekly
0/5

What is Adloop Google Ads Control?

Adloop Google Ads Control is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ai command center for google ads, ga4, and tracking code.

The AI command center for Google Ads, GA4, and tracking code.

This server falls under the Marketing & SEO category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • The AI command center for Google Ads, GA4, and tracking code

Use Cases

AI command center for Google Ads
GA4 integration
Tracking code management
kLOsk

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx adloop

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Adloop Google Ads Control

Adloop is a Python-based MCP server that serves as an AI command center for Google Ads, Google Analytics 4 (GA4), and tracking code management. It exposes 43 tools across read analytics, campaign management, keyword planning, cross-channel attribution, and tracking validation — all with built-in safety guardrails including a draft-preview-confirm workflow and configurable daily budget ceilings. It is designed for performance marketers and developers who want to manage Google Ads campaigns and analyze GA4 data through conversational AI without directly using the Google Ads UI.

Prerequisites

  • Python 3.10 or later with uv package manager installed
  • A Google Ads developer token (obtained from Google Ads API center)
  • A Google Ads customer ID and optionally a manager account login_customer_id
  • A GA4 property ID and Google OAuth credentials (service account JSON or OAuth2 client)
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Install Adloop

Install Adloop from PyPI using pip, or clone from source and use uv sync for development setup.

pip install adloop
# OR from source:
git clone https://github.com/kLOsk/adloop.git
cd adloop
uv sync
2

Initialize the configuration

Run 'adloop init' to create the configuration file at ~/.adloop/config.yaml. The wizard will prompt you for your Google Ads and GA4 credentials.

adloop init
3

Edit the configuration file

Open ~/.adloop/config.yaml and fill in your credentials. Set max_daily_budget and require_dry_run safety settings to match your risk tolerance.

# ~/.adloop/config.yaml
google:
  credentials_path: /path/to/your/oauth-credentials.json
ga4:
  property_id: "123456789"
ads:
  developer_token: "your-developer-token"
  customer_id: "111-222-3333"
  login_customer_id: "999-888-7777"
safety:
  max_daily_budget: 50
  require_dry_run: true
4

Add the MCP server to your client configuration

Configure your MCP client to run Adloop. If installed via pip, use the adloop command directly. If using uv from source, use 'uv run adloop'.

{
  "mcpServers": {
    "adloop": {
      "command": "adloop",
      "args": ["serve"]
    }
  }
}
5

Run a health check

Use the health_check tool through your MCP client to validate connectivity to Google Ads and GA4 before starting your first analysis.

Adloop Google Ads Control Examples

Client configuration

Claude Desktop configuration for Adloop installed via pip. For source installs with uv, replace 'adloop' with 'uv' and add '--directory /path/to/adloop run adloop' as args.

{
  "mcpServers": {
    "adloop": {
      "command": "adloop",
      "args": ["serve"]
    }
  }
}

Prompts to try

Example prompts that use Adloop's Google Ads and GA4 tools for campaign analysis and optimization.

- "Run a health check to verify Google Ads and GA4 connectivity"
- "Which landing pages receive paid traffic but generate zero conversions?"
- "Identify unprofitable search terms and add them as negative keywords"
- "Compare my tracking code against GA4 events to find mismatches"
- "Show me keyword performance for my top 5 campaigns this month"
- "Draft a responsive search ad for our summer sale with 3 headlines and 2 descriptions"
- "Estimate budget requirements for the keywords 'project management software' in Germany"

Troubleshooting Adloop Google Ads Control

health_check fails with Google Ads authentication error

Verify your developer_token, customer_id, and credentials_path in ~/.adloop/config.yaml. The credentials JSON must be a valid OAuth2 client or service account file with Google Ads API access enabled in Google Cloud Console. Run 'adloop init' again to re-enter credentials.

GA4 tools return 'property not found' or permission denied

Confirm your property_id matches the numeric ID of your GA4 property (found in GA4 Admin > Property Settings). Your OAuth credentials must belong to a Google account with at least Viewer access to that GA4 property.

Write tools (campaign creation, keyword changes) fail even after confirmation

Check that require_dry_run in config.yaml is set correctly. With require_dry_run: true, all write operations must go through a preview step first. Also verify that your Google Ads account has the appropriate permissions for the operation and that max_daily_budget is not set below the campaign's current budget.

Frequently Asked Questions about Adloop Google Ads Control

What is Adloop Google Ads Control?

Adloop Google Ads Control is a Model Context Protocol (MCP) server that ai command center for google ads, ga4, and tracking code. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Adloop Google Ads Control?

Follow the installation instructions on the Adloop Google Ads Control GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Adloop Google Ads Control?

Adloop Google Ads Control works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Adloop Google Ads Control free to use?

Yes, Adloop Google Ads Control is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Marketing & SEO MCP Servers

Explore all marketing & seo servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "adloop": { "command": "npx", "args": ["-y", "adloop"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Adloop Google Ads Control?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides