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 with an MCC (Manager Account) and a developer token
  • A Google Cloud project with OAuth credentials (the wizard walks you through creating one, see Google Cloud project setup)

​
Run the wizard

The wizard walks you through:
  1. Google Cloud setup: your project, the required APIs, an OAuth client
  2. Developer token and MCC account ID
  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 developer token.