Skip to main content
The open-source edition runs on your machine and uses your own (free) Google Cloud project for OAuth. One-time setup takes about five minutes with the wizard.

​
Requirements

  • Python 3.11+
  • A Google Ads account (a Manager Account is optional; only needed to reach several accounts through one login)
  • A Google Cloud project with OAuth credentials and Google Ads API access (the wizard walks you through it, see Google Cloud project setup). No developer token since September 2026.

​
Run the wizard

The wizard walks you through:
  1. Google Cloud setup: your project, the required APIs, an OAuth client
  2. API access and MCC account ID: both optional prompts now; access is applied for on the Cloud project, the MCC only matters with a Manager Account
  3. OAuth sign-in: opens a browser, or prints a URL on headless servers
  4. Account discovery: finds your GA4 properties and Ads accounts automatically
  5. Optional services: pin a GTM container and Search Console property (auto-discovered), store a PageSpeed API key. Skip any step with Enter.
  6. Safety defaults: budget cap and dry-run preference
  7. Toolsets: optionally expose only part of the tool catalog to cut context cost
  8. Editor snippets: ready-to-paste MCP configuration for Claude Code and Cursor, including your toolset selection
Configuration lives in ~/.adloop/config.yaml; see the configuration reference.

​
Connect your AI

The wizard prints the exact snippets. In short:
For other clients, see Connect your AI.
Prefer zero setup? AdLoop Cloud runs the same tools without a Google Cloud project or an API access application.