Maintainer of this skill?
by kLOsk
Google Ads MCP server for Claude, ChatGPT and Cursor, with Reddit Ads, GA4 and Tag Manager. Every change is previewed first.
# Add to your Claude Code skills
git clone https://github.com/kLOsk/adloopGuides for using mcp servers skills like adloop.
See how adloop compares with popular alternatives.
adloop is an open-source mcp servers skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by kLOsk. Google Ads MCP server for Claude, ChatGPT and Cursor, with Reddit Ads, GA4 and Tag Manager. Every change is previewed first. It has 298 GitHub stars.
adloop's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/kLOsk/adloop" and add it to your Claude Code skills directory (see the Installation section above).
adloop is primarily written in Python. It is open-source under kLOsk on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other MCP Servers skills you can browse and compare side by side. Open the MCP Servers category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh adloop against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
The Google Ads MCP server for Claude, ChatGPT and Cursor.
Plus Reddit Ads, GA4 and your tracking code, with a preview before every change.
An MCP server that gives your AI assistant read + write access to Google Ads, Reddit Ads and GA4 — with safety guardrails that prevent accidental spend.
☁️ Skip the setup — use AdLoop Cloud (free plan, no card) · or self-host: pip install adloop
[!TIP] AdLoop Cloud is the hosted version of this project, with a free plan that needs no credit card. Connect Google in two clicks and use the full toolset from claude.ai, ChatGPT, Claude Code, Cursor, or Gemini. No Google Cloud project, no API access application, no OAuth verification wait. EU-hosted, GDPR-first, DPA included.
📚 Documentation: docs.getadloop.com — setup guides per AI client, toolsets, the safety model, and troubleshooting for both editions.
Both versions run the same tools with the same safety model. The difference is who handles the plumbing:
| ☁️ AdLoop Cloud | 🛠️ Self-hosted (this repo) | |
|---|---|---|
| Setup | Connect Google in two clicks | ~5 min: own Google Cloud project + adloop init |
| Google Cloud project | Not needed | Required (free) |
| Ads API access | Not needed | Granted to your Cloud project (no developer token, no MCC since Sept 2026) |
| Works with | claude.ai, ChatGPT, Claude Code, Cursor, Gemini | Claude Code, Cursor, Claude Desktop, any local MCP client |
| Where your data flows | EU servers (Germany), GDPR-first, DPA included | 100% your machine — nothing leaves it |
| Updates | Automatic | pip install -U adloop |
| Price | Free plan, no card; paid plans for more accounts and volume | Free forever (MIT) |
Not sure? Start with Cloud — it's the fastest way to see what AdLoop can do, and it's the only way to use AdLoop from claude.ai or ChatGPT. Self-host when you want everything on your own machine or need to modify the code. And if you're here to hack on AdLoop itself: welcome, keep scrolling.
AdLoop exists because managing Google Ads alongside your code is a mess. These are the specific problems it handles:
"My conversions dropped and I don't know why." AdLoop cross-references Ads clicks, GA4 sessions, and conversion events in one query. It detects whether the gap is from GDPR consent rejection, broken tracking, or an actual landing page problem — before you waste hours checking each dashboard separately.
"I'm wasting ad spend on irrelevant searches." Pull your search terms report, identify the junk, and add negative keywords — all from a single conversation in your IDE. No context-switching to the Ads UI.
"Is my tracking even working?" Compare the event names in your actual codebase against what GA4 is receiving. Find the mismatches: events you fire that GA4 never sees, events GA4 records that you didn't know about.
"I need to create ads but the Google Ads UI is hostile." Draft responsive search ads, create campaigns, add keywords — all through natural language. Every change shows a preview first. Nothing goes live without your explicit confirmation: in Claude, ChatGPT and VS Code the preview is an approval card, and only your click on Apply changes the account (the AI cannot press it). New ads and campaigns start paused.
"My landing page gets paid traffic but nobody converts." AdLoop joins your ad final URLs with GA4 page-level data. See which pages get clicks but no conversions, which have high bounce rates, and which ones are orphaned from any ad campaign.
"Are conversions even being tagged on every page?" AdLoop reads your live Google Tag Manager container, joins it against the events in your codebase and the events firing in GA4, and tells you exactly which conversions are being captured, which tags are paused, which page-scope filters are too narrow, and which codebase events have no tag at all — the kind of three-way audit GTM Preview can't give you in a single view.
"I don't know if my EU consent setup is causing data gaps." In Europe, 30-70% of users reject analytics cookies. AdLoop accounts for this automatically — it won't diagnose a normal GDPR consent gap as broken tracking.
Every tool exists because of an actual problem hit while running real Google Ads campaigns. The cross-reference tools exist because we kept manually asking the AI to "get Ads data, then get GA4 data, then compare them" — so we automated the join. The Broad Match + Manual CPC safety rule exists because the AI once created that exact combination and wasted budget. The GDPR consent awareness exists because the AI kept diagnosing normal EU cookie rejection as broken tracking.
The best features come from real workflows. If you're using AdLoop and find yourself wishing it could do something it can't, open an issue describing your situation — not just "add feature X" but "I was trying to do Y and couldn't because Z." The context matters more than the request.
Quick start:
pip install adlooporgit clone https://github.com/kLOsk/adloop.git && cd adloop && uv sync && uv run adloop init— or zero setup on AdLoop Cloud
| Tool | What It Does |
|---|---|
health_check |
Test OAuth, GA4, and Ads connectivity in one call — actionable error messages if anything is broken. Also reports the pinned Google Ads API version and warns if a newer version is available. |
| Tool | What It Does |
|---|---|
get_account_summaries |
List GA4 accounts and properties |
run_ga4_report |
Custom reports: sessions, users, key events, page performance. Optional dimension and metric filters, ordering, paging, and a comparison period |
run_realtime_report |
Live data — verify tracking fires after deploys |
get_tracking_events |
All configured events and their volume |
list_key_events |
The property's key events (conversions) with counting method, create time and whether they can be deleted |
list_ga4_dimensions_and_metrics |
Every dimension and metric the property can report on, including custom ones, with search |
| Tool | What It Does |
|---|---|
list_accounts |
Discover accessible Ads accounts |
get_campaign_performance |
Campaign metrics: impressions, clicks, cost, conversions, CPA, Search impression share and share lost to budget/rank |
get_ad_performance |
Ad copy analysis: headlines, descriptions, CTR, policy approval status and topics |
get_keyword_performance |
Keywords — quality scores, competitive metrics |
get_search_terms |
What users actually searched before clicking |
get_negative_keywords |
List direct campaign-level negative keywords |
get_negative_keyword_lists |
List all shared negative keyword lists (SharedSets) — names, IDs, status, keyword count |
get_negative_keyword_list_keywords |
List the keywords inside a specific shared negative keyword list |
get_negative_keyword_list_campaigns |
List which campaigns a shared negative keyword list is attached to |
get_recommendations |
Google's auto-generated recommendations with type, estimated impact, and campaign context |
get_recommendation_subscriptions |
Which recommendation types Google applies automatically (auto-apply), with status and last change; flags any that are on |
get_pmax_performance |
Performance Max campaign metrics with network breakdown + asset group ad strength |
get_pmax_assets |
Per-asset details for PMax — field type, serving status, content |
get_asset_group_signals |
A PMax asset group's search themes and audience signal, plus the audiences available for it |
get_detailed_asset_performance |
Top-performing asset combinations — which headline+description+image combos Google selects most |
get_audience_performance |
Audience segment performance — remarketing, in-market, affinity, demographics |
get_shopping_product_performance |
Spend, conversions, CPA and ROAS per product across Shopping and Performance Max, plus products that spent without converting |
get_change_history |
What changed before the drop: who changed what and when, through which client (UI, API, scripts, auto-applied recommendations), last 30 days |
get_demographic_targeting |
List demographic criteria (age/gender/parental status/income) on an ad group or campaign |
get_audience_lists |
The account's remarketing and customer lists (size, eligibility, open/closed), custom and combined segments |
search_audience_segments |
Find Google's in-market and affinity segments by name |
get_audience_targeting |