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 65 tools across eight platforms — GA4, Search Console, Google Ads, Meta Ads, Stripe, Shopify, WordPress and GitHub — plus AI monitoring agents. 35 are read-only (analytics, audits, reports, monitoring activity); 29 are writes (campaign creation and edits, SEO publishing, monitoring rules). Every tool carries a readOnlyHint or destructiveHint annotation so Claude asks for confirmation before writes.

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 65 tools, grouped by platform. Read/Write annotations are shown inline — Claude requests your confirmation before any write — and Team+ marks the 36 tools that need Team or Agency.

📊

Google Analytics 4

5 tools
list_ga4_propertiesList all GA4 properties your account has access to.Read
get_ga4_metricsTraffic, engagement and conversion metrics for any GA4 property — flexible date ranges and dimensions.Read
list_ga4_eventsList all tracked events in a property with counts — the starting point for funnel analysis.Read
analyze_ga4_funnelBuild a conversion funnel and get step-by-step drop-off rates.Read
get_ai_referral_trafficMeasure traffic referred from AI assistants — ChatGPT, Perplexity, Gemini, Claude, Copilot.ReadTeam+
🔍

Google Search Console

2 tools
list_gsc_sitesList all verified sites in your Search Console account.Read
get_gsc_metricsClicks, impressions, CTR and average position — by query, page, country, device or date.Read
🎯

Google Ads

23 tools
list_google_ads_accountsList all Google Ads accounts linked to your profile.Read
get_google_ads_metricsCampaign, ad group and keyword performance metrics.Read
get_google_ads_search_termsThe actual search queries that triggered your ads, with performance.Read
get_google_ads_budgetsDaily budgets, total budgets and budget utilization across campaigns.Read
get_google_ads_change_historyWho changed what, and when — budgets, bids, statuses, keywords, targeting.Read
get_campaign_negative_keywordsList the negative keywords on a campaign.Read
get_google_ads_audiencesAudience targeting and demographics for a campaign or ad group, with optional metrics.Read
get_google_keyword_ideasKeyword Planner research — search volume, competition and CPC estimates.Read
audit_google_campaignFull campaign audit with actionable recommendations to improve performance.Read
get_google_recommendationsRead Google's own optimization recommendations for your account.Read
apply_google_recommendationApply or dismiss a Google recommendation — only after you approve it.WriteTeam+
create_google_campaignCreate a campaign with budget — always created PAUSED, never spends until you enable it.WriteTeam+
create_google_campaign_fullCreate a complete Search campaign in one call — campaign, ad group, keywords and ad, all PAUSED.WriteTeam+
create_google_ad_groupCreate an ad group with keywords inside an existing campaign.WriteTeam+
create_google_adCreate a responsive search ad inside an ad group — created PAUSED.WriteTeam+
update_google_campaignEdit a campaign — status, budget, bidding strategy, name or tracking.WriteTeam+
update_google_adEdit an existing responsive search ad — headlines, descriptions, final URL or status.WriteTeam+
update_google_ad_groupEdit an ad group — status, name or default CPC bid.WriteTeam+
manage_google_keywordsBulk keyword management — add, pause, remove, change bids and match types, negatives.WriteTeam+
manage_google_conversionsList or create conversion actions — the prerequisite for smart bidding.WriteTeam+
set_campaign_targetingSet locations, language, ad schedule, negatives and device bid adjustments.WriteTeam+
set_campaign_assetsSet campaign-level callouts and structured snippets.WriteTeam+
set_google_ads_audiencesSet audience targeting on an existing campaign or ad group.WriteTeam+
📣

Meta Ads (Facebook + Instagram)

13 tools
list_meta_ads_accountsList all Meta ad accounts connected to your profile.Read
get_meta_ads_metricsFacebook and Instagram ad performance — spend, reach, results, ROAS.Read
list_meta_pagesList the Facebook Pages you can run ads from.Read
get_meta_page_engagementOrganic engagement metrics on your Facebook Page posts.Read
list_meta_creativesBrowse the image creatives in your Meta ads library.Read
get_meta_messaging_breakdownClick-to-message conversations by app — WhatsApp vs Messenger vs Instagram Direct.Read
create_meta_campaignCreate a Facebook/Instagram campaign.WriteTeam+
create_meta_campaign_fullCreate a complete Meta campaign in one call from a plain-language goal — campaign, ad set and ad, all PAUSED.WriteTeam+
create_meta_adsetCreate an ad set with targeting, placement and scheduling.WriteTeam+
create_meta_adCreate an ad with creative — image, text and link.WriteTeam+
update_meta_campaignEdit a campaign — status, budget, bid strategy or name.WriteTeam+
update_meta_adsetEdit an ad set — status, budget, targeting, optimization goal or schedule.WriteTeam+
update_meta_adEdit an ad — pause, activate, rename or swap the creative.WriteTeam+
💳

Stripe

1 tools
get_stripe_metricsRevenue, payments, subscriptions, MRR, churn and customer data from your Stripe account.Read
🛍️

Shopify

4 tools
get_shopify_shopYour connected store's info — name, domain, currency, country, plan.Read
get_shopify_metricsStore sales metrics — revenue, orders, average order value, items sold.Read
get_shopify_ordersOrders for a date range — number, date, total, items, payment and fulfillment status.Read
get_shopify_top_productsTop-selling products by revenue and units, aggregated from order line items.Read
📝

WordPress — Search Autopilot

11 tools
audit_wordpress_seoAudit your site for SEO opportunities — fuses your content with GSC rankings into a prioritized fix list.ReadTeam+
audit_keyword_cannibalizationFind queries where your own pages compete against each other — works for any site with GSC.ReadTeam+
list_wordpress_postsInventory and search the posts on your connected WordPress site.ReadTeam+
get_wordpress_postFull content and SEO meta of one post — for analysis or before a refresh.ReadTeam+
update_wordpress_postRewrite SEO title and meta, refresh content, change slug or set noindex.WriteTeam+
publish_blog_postCreate a new blog post from finished HTML — draft by default, never live unless you enable it.WriteTeam+
set_post_faq_schemaAdd FAQPage structured data to a post — boosts rich results and AI-search citations.WriteTeam+
set_wordpress_featured_imageSet a post's featured image from any image URL.WriteTeam+
manage_wordpress_redirectsManage 301/302 redirects — forward old or changed URLs to new ones.WriteTeam+
list_wordpress_authorsList your site's authors and categories — set the right byline for E-E-A-T.ReadTeam+
create_wordpress_authorCreate a new author byline to attribute posts to a named expert.WriteTeam+
🐙

GitHub — Search Autopilot

1 tools
open_seo_prApply an SEO change to your GitHub-hosted site (Next.js, Astro, Hugo, Jekyll, static) via a pull request — never a direct push.WriteTeam+
🤖

AI Monitoring Agents

5 tools
create_monitoring_ruleCreate an agent that watches a metric on a schedule and alerts you when conditions are met.WriteTeam+
list_monitoring_rulesSee every agent that's running and what it watches.Read
get_rule_activityRecent agent activity — triggers, alerts and pending approvals.Read
update_monitoring_ruleChange an agent's thresholds, frequency or enabled state.WriteTeam+
delete_monitoring_ruleDelete a monitoring agent permanently.WriteTeam+

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 trial. After that, Solo covers 29 of the 65 tools — analytics, research, reporting and audits. Team and Agency add the other 36: campaign creation and management, the WordPress/GitHub SEO suite, and monitoring-rule writes. Agency is Team's toolset at agency scale, not a bigger toolset. Live pricing is always on the plans page.

Solo

$25 / month

7-day free trial · cancel anytime
  • 29 tools — everything read-only
  • GA4, Google Ads, Meta Ads, GSC, Stripe, Shopify, WordPress
  • Audits, reports, search-term analysis
  • Keyword research
  • List + view AI monitoring rules + activity
  • 2 accounts per connector
Team

$99 / month

Everything in Solo, plus the write tools
  • All 65 tools (Solo's 29 + 36 more)
  • Create campaigns, ad groups, ads
  • Manage keywords (add / pause / change bid / match type)
  • Audience targeting, location/schedule, assets
  • Meta campaign + ad-set + ad creation & edits
  • 24/7 AI monitoring agents (create / update / delete rules)
  • WordPress + GitHub SEO publishing
  • 10 accounts per connector · 5 seats
Agency

$249 / month

Team's toolset, built for client portfolios
  • All 65 tools
  • Unlimited accounts per connector
  • 20 seats
  • Unlimited account swaps
  • White-labelled reports

On a legacy Pro or Premium plan? Both are grandfathered — your price and access are unchanged, and nothing here requires you to move.

Support

Two ways to get help, ranked by speed.

Fastest

Discord community

Active community, founder reads every channel.
Direct

Email support

[email protected] · 24h response.