Documentation · v1.0

1ClickReport for Claude.

A Model Context Protocol (MCP) connector that lets Claude query and manage your live marketing data across Google Ads, Meta Ads, GA4, Search Console, and Stripe — in plain English.

Overview

1ClickReport is a remote MCP server hosted at https://mcp.1clickreport.com/mcp. Once connected, Claude can ask questions and run actions against your real marketing data without you having to copy-paste numbers, export CSVs, or stare at a Looker Studio dashboard.

The connector exposes 29 tools across five platforms. 17 are read-only (analytics, audits, reports). 12 are destructive (campaign creation and edits). Every tool includes the readOnlyHint or destructiveHint annotation so Claude can decide which ones need explicit user confirmation.

Who it's for: Marketing teams, agencies, and founders who want a senior strategist for their ad accounts on demand. Works in claude.ai, Claude Desktop, and Claude Code.

Install

Three install paths depending on which Claude product you use. All three connect to the same hosted MCP server — no self-hosting required.

🌐
Web · recommended for most users

claude.ai

Use Claude in your browser
  1. Open claude.ai and sign in.
  2. Click your profile icon (bottom-left) → Settings.
  3. In Settings, click Connectors in the left sidebar.
  4. Scroll to the bottom → click + Add custom connector.
  5. Paste the MCP URL into the URL field: 
    https://mcp.1clickreport.com/mcp
  6. Click Add. An OAuth window opens automatically. Sign in with your Google account and grant access.
  7. Done. Start a new chat — your tools are now available. Try: "List my GA4 properties" to verify.
If something's off
  • Don't see "Connectors" in Settings? The custom-connector feature requires Claude Pro or Team. Free plans can't add custom MCPs.
  • OAuth window blocked? Disable popup blockers for claude.ai and app.1clickreport.com.
  • Tools show but error on first use? You probably haven't connected the platform (Google Ads, Meta, etc.) on the 1ClickReport side — visit app.1clickreport.com/integrations and authorize each platform you want Claude to access.
🖥️
Desktop · macOS + Windows

Claude Desktop

Prefer a native app over browser
  1. Open Claude Desktop. (Don't have it? Download it here.)
  2. Click the gear icon → Settings. (On macOS: ⌘ + ,)
  3. Settings sidebar → Connectors.
  4. Click + Add custom connector.
  5. Paste the MCP URL: 
    https://mcp.1clickreport.com/mcp
  6. Click Add. OAuth opens in-app or in your browser. Sign in and grant access.
  7. No restart needed. Open a new chat and your tools are live. Try: "Audit my Google Ads account" to verify.
If something's off
  • Don't see "Connectors" in Settings? Update Claude Desktop to the latest version — the Connectors UI rolled out in late 2025. Help → Check for Updates.
  • OAuth doesn't complete? Make sure your default browser is set correctly — the OAuth flow uses it for the redirect.
  • Want the legacy install path? The old claude_desktop_config.json editing approach still works for older Desktop versions but is no longer recommended.
⚡
CLI · for developers

Claude Code

Build agents in the terminal
  1. Make sure you have Claude Code installed. (Install guide)
  2. From any terminal, run: 
    claude mcp add \
  --transport http \
  1clickreport \
  https://mcp.1clickreport.com/mcp \
  --scope user
  3. The --scope user flag installs it globally — available in every directory you run Claude Code from. Use --scope project to scope it to one project (creates a .mcp.json file you can commit).
  4. On first tool use, Claude Code opens a browser window for OAuth. Sign in with Google and grant access.
  5. Verify it loaded: 
    claude mcp list
    You should see 1clickreport in the output. Or just start claude and ask "What MCP tools do I have?"
If something's off
  • Command not found? Update Claude Code: claude --version should show v1.0+. Older versions don't support --transport http.
  • OAuth browser doesn't open? Run claude mcp auth 1clickreport manually to trigger the auth flow.
  • Want to remove? claude mcp remove 1clickreport --scope user

Authentication & data access

1ClickReport uses OAuth 2.0 with PKCE. You sign in once via Google, then individually authorize each platform (Google Ads, Meta Ads, GA4, etc.). Tokens are stored encrypted on our backend and refreshed automatically.

What we access

  • Read-only access to GA4 properties you own
  • Read + write access to Google Ads accounts you own (Premium only)
  • Read + write access to Meta Ads accounts you own (Premium only)
  • Read-only Search Console sites you own
  • Read-only Stripe data via Stripe Connect
  • Your basic Google profile (email, name)

What we don't do

  • Sell or share your data with third parties
  • Train models on your private data
  • Store passwords (we never see them — OAuth only)
  • Access accounts you haven't connected
  • Make changes without a destructive-tool confirmation

Disconnecting

Revoke access anytime at app.1clickreport.com/integrations or directly via Google's app permissions page. We retain logs for 30 days then purge.

Tool reference

All 29 tools, grouped by platform. Each tool's annotation (read-only or destructive) is shown inline so Claude can request confirmation before running write operations.

📊

Google Analytics 4

4 tools
list_ga4_propertiesAll GA4 properties the user has access to, with default property highlighted.Read
get_ga4_metricsSessions, users, conversions, revenue, engagement — with optional dimensions (country, device, source) and filters.Read
list_ga4_eventsAll tracked events on a property with counts. Required before building a funnel.Read
analyze_ga4_funnelMulti-step conversion funnel with per-step drop-off rates. Optional breakdown by device, source, country.Read
🔎

Google Search Console

2 tools
list_gsc_sitesAll GSC sites the user owns or has access to (domain + URL-prefix properties).Read
get_gsc_metricsClicks, impressions, CTR, position — broken down by query, page, country, device, search appearance, or date.Read
🎯

Google Ads

17 tools
list_google_ads_accountsAll Google Ads customer accounts the user has access to, including MCC hierarchies.Read
get_google_ads_metricsPerformance metrics (cost, clicks, conversions, ROAS, Quality Score) at campaign / ad-group / ad / keyword / asset level.Read
get_google_ads_search_termsSearch Terms Report — the actual queries that triggered your ads, with cost and conversion data.Read
get_google_ads_budgetsDaily budgets, total budgets, utilization, and delivery method for all campaigns.Read
get_google_keyword_ideasGoogle Keyword Planner data — search volume, competition, CPC estimates, related keyword ideas.Read
get_campaign_negative_keywordsAll negative keywords on a campaign with match type and status.Read
get_google_ads_audiencesAudience targeting and demographics on a campaign or ad group, with optional performance metrics.Read
audit_google_campaign7-category health audit (0-100 score). Catches Quality Score issues, conversion-tracking bugs, budget waste, and structural problems.Read
create_google_campaignCreate a new Search / Display / Performance Max / Demand Gen / Video / Shopping campaign. Always created PAUSED.Write
create_google_ad_groupAdd an ad group with keywords inside an existing campaign.Write
create_google_adCreate a responsive search ad (RSA). Validates 30/90 character limits before submitting.Write
update_google_campaignEdit campaign status, daily budget, bidding strategy, name, or UTM tracking.Write
update_google_ad_groupEdit ad group status, name, or default CPC bid.Write
manage_google_keywordsBulk-add, pause, enable, remove, change bid, or change match type for keywords in an ad group.Write
set_google_ads_audiencesSet demographic targeting (age, gender, income, parental status), remarketing lists, or in-market audiences on a campaign or ad group.Write
set_campaign_targetingSet locations, language, ad schedule, negative keywords, and device bid adjustments.Write
set_campaign_assetsAdd callouts and structured snippets at the campaign level.Write
📱

Meta Ads (Facebook + Instagram)

5 tools
list_meta_ads_accountsAll Meta Ads accounts the user has access to with currency and status.Read
get_meta_ads_metricsPerformance metrics at account / campaign / ad-set / ad level. Optional creative-asset breakdowns (image, video, headline, body).Read
create_meta_campaignCreate a new Meta campaign with objective (Traffic / Leads / Sales / Awareness / Engagement / App). Always created PAUSED. (Pending Meta App Review — coming soon to Premium.)SOON
create_meta_adsetAdd an ad set with targeting (countries, age, gender, interests), optimization goal, and budget. (Pending Meta App Review — coming soon to Premium.)SOON
create_meta_adCreate an ad with creative (image, primary text, headline, link URL, call-to-action). (Pending Meta App Review — coming soon to Premium.)SOON
💳

Stripe

1 tool
get_stripe_metricsRevenue, MRR, payments (success/failed), subscriptions (active/new/canceled), customers, refunds, daily trends.Read

Example prompts

These are real prompts you can paste into Claude once your MCP is connected. Each one auto-triggers the right tool(s) without you naming them.

Audit my Google Ads account and tell me the top 5 things to fix. Score each campaign on a 7-category scorecard.
Compare my GA4 funnel performance from page_view to signup_complete over the last 30 days vs the previous 30 days. Where am I losing users?
Find search terms in my Google Ads that triggered ads but produced zero conversions. Group by likely competitor brand and calculate annual budget leak.
Show me my top GSC queries ranking position 6–20 with high impressions and low CTR. These are my next blog post priorities.
Compare cost per real lead vs cost per button click on my Google Ads conversions. Which conversion actions is Smart Bidding actually optimizing for?

Plans

Connect for free with the 7-day Pro trial. After that, all 17 read-only tools require Pro; the 12 write tools require Premium.

Pro

$25 / month

7-day free trial · cancel anytime
  • All read-only tools (17)
  • GA4, Google Ads, Meta Ads, GSC, Stripe
  • Audits, reports, search-term analysis
  • Keyword research
  • 17 expert skills included (free)
Premium

$99 / month

Includes everything in Pro
  • All 29 tools (Pro + 12 destructive)
  • Create campaigns, ad groups, ads
  • Manage keywords (add / pause / change bid / match type)
  • Audience targeting, location/schedule, assets
  • Meta campaign + ad-set + ad creation

Support

Three ways to get help, ranked by speed.

Fastest

Discord community

Active community, founder reads every channel.
Direct

Email support

[email protected] · 24h response.