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 64 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 64 tools, grouped by platform. Read/Write annotations are shown inline — Claude requests your confirmation before any write — and Premium marks tools on the Premium plan.

📊

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.ReadPremium
🔍

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

22 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.WritePremium
create_google_campaignCreate a campaign with budget — always created PAUSED, never spends until you enable it.WritePremium
create_google_campaign_fullCreate a complete Search campaign in one call — campaign, ad group, keywords and ad, all PAUSED.WritePremium
create_google_ad_groupCreate an ad group with keywords inside an existing campaign.WritePremium
create_google_adCreate a responsive search ad inside an ad group — created PAUSED.WritePremium
update_google_campaignEdit a campaign — status, budget, bidding strategy, name or tracking.WritePremium
update_google_ad_groupEdit an ad group — status, name or default CPC bid.WritePremium
manage_google_keywordsBulk keyword management — add, pause, remove, change bids and match types, negatives.WritePremium
manage_google_conversionsList or create conversion actions — the prerequisite for smart bidding.WritePremium
set_campaign_targetingSet locations, language, ad schedule, negatives and device bid adjustments.WritePremium
set_campaign_assetsSet campaign-level callouts and structured snippets.WritePremium
set_google_ads_audiencesSet audience targeting on an existing campaign or ad group.WritePremium
📣

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.WritePremium
create_meta_campaign_fullCreate a complete Meta campaign in one call from a plain-language goal — campaign, ad set and ad, all PAUSED.WritePremium
create_meta_adsetCreate an ad set with targeting, placement and scheduling.WritePremium
create_meta_adCreate an ad with creative — image, text and link.WritePremium
update_meta_campaignEdit a campaign — status, budget, bid strategy or name.WritePremium
update_meta_adsetEdit an ad set — status, budget, targeting, optimization goal or schedule.WritePremium
update_meta_adEdit an ad — pause, activate, rename or swap the creative.WritePremium
💳

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

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.WritePremium
🤖

AI Monitoring Agents

5 tools
create_monitoring_ruleCreate an agent that watches a metric on a schedule and alerts you when conditions are met.WritePremium
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.WritePremium
delete_monitoring_ruleDelete a monitoring agent permanently.WritePremium

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 Premium trial. After that, Pro covers the 29 analytics, research and reporting tools; the 35 Premium tools add campaign management, the WordPress/GitHub SEO suite, and monitoring-rule writes.

Pro

$25 / month

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

$99 / month

Includes everything in Pro
  • All 64 tools (Pro + 35 Premium)
  • 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)

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.