/ Directory / Playground / google-meta-ads-ga4-mcp
● Community irinabuht12-oss ⚡ Instant

google-meta-ads-ga4-mcp

by irinabuht12-oss · irinabuht12-oss/google-meta-ads-ga4-mcp

Unified MCP server for Google Ads, Meta Ads, and GA4 — 250+ tools for campaign management, analytics, and optimization.

google-meta-ads-ga4-mcp provides a single MCP server that unifies management of Google Ads (150+ tools), Meta Ads (80+ tools), and Google Analytics 4 (20+ tools). It handles campaign creation, keyword research, ad management, audience targeting, creative assets, performance analytics, and conversion tracking. Uses OAuth 2.1 for secure authentication without local API key storage.

Why use it

Key features

Live Demo

What it looks like in practice

google-meta-ads-ga4.replay ▶ ready
0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "google-meta-ads-ga4",
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json
{
  "context_servers": {
    "google-meta-ads-ga4": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add google-meta-ads-ga4 -- TODO 'See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp'

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use google-meta-ads-ga4-mcp

How to compare ad performance across Google and Meta with one prompt

👤 Digital marketers managing multi-platform campaigns ⏱ ~15 min intermediate

When to use: Your weekly performance review needs data from both Google Ads and Meta Ads.

Prerequisites
  • OAuth authentication complete — Follow the setup guide to authorize Google and Meta accounts
Flow
  1. Pull cross-platform metrics
    Show me last week's performance for all active campaigns across Google Ads and Meta Ads. Include spend, impressions, clicks, CTR, and CPA.✓ Copied
    → Combined table with metrics from both platforms
  2. Identify underperformers
    Which campaigns have a CPA more than 2x our target of $25? Recommend whether to pause, adjust budget, or change targeting.✓ Copied
    → Specific recommendations with data backing

Outcome: A unified performance view with actionable optimization recommendations.

Pitfalls
  • Attribution windows differ between platforms — Specify the same date range and note that Google and Meta may count conversions differently

Create a Meta Ads campaign from scratch with AI assistance

👤 Small business owners running their own ads ⏱ ~20 min beginner

When to use: You want to set up a new Meta Ads campaign without navigating the complex Ads Manager UI.

Prerequisites
  • Meta Ads account authorized — Complete OAuth setup for your Meta Business account
Flow
  1. Create the campaign
    Create a Meta Ads campaign for my online store targeting women 25-45 interested in organic skincare. Daily budget $50, optimizing for purchases.✓ Copied
    → Campaign, ad set, and targeting configured
  2. Upload creative
    Upload these 3 product images as ad creatives and create carousel ads with them.✓ Copied
    → Ads created with images and copy

Outcome: A complete Meta Ads campaign ready to launch.

Pitfalls
  • Audience too narrow leads to high CPMs — Start with broader targeting and narrow based on performance data

Analyze website traffic patterns using GA4 tools

👤 Growth marketers and product managers ⏱ ~15 min beginner

When to use: You want to understand where your traffic comes from and how users behave.

Prerequisites
  • GA4 property authorized — Complete OAuth setup for your Google Analytics account
Flow
  1. Pull traffic report
    Show me a GA4 report of traffic sources for the past 30 days. Break down by channel, with sessions, engagement rate, and conversions.✓ Copied
    → Channel breakdown with key metrics
  2. Analyze user behavior
    For organic search traffic, what are the top landing pages and average engagement time? Which pages have the highest bounce rate?✓ Copied
    → Page-level analysis with actionable insights

Outcome: Clear understanding of traffic patterns and user behavior for optimization.

Pitfalls
  • GA4 data can have 24-48 hour processing delays — Use realtime reporting for today's data, standard reports for historical analysis

Combinations

Pair with other MCPs for X10 leverage

google-meta-ads-ga4 + filesystem

Export campaign performance data to CSV files for further analysis

Export last month's Google Ads campaign performance to a CSV file in ~/reports/.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
google_ads_campaigns account_id, filters? List or manage Google Ads campaigns 1 API call
meta_ads_campaigns account_id, filters? List or manage Meta Ads campaigns 1 API call
ga4_report property_id, date_range, dimensions, metrics Pull GA4 analytics reports 1 API call
keyword_research seed_keywords, language, location Research keywords for Google Ads campaigns 1 API call
meta_audience_create targeting_spec Create a custom or lookalike audience on Meta 1 API call

Cost & Limits

What this costs to run

API quota
Subject to Google Ads API and Meta Marketing API rate limits
Tokens per call
300–2000 tokens depending on report size
Monetary
The MCP server itself requires setup — check pricing at the project's site. API calls are free within platform quotas.
Tip
Pull aggregated reports instead of item-by-item queries to stay within rate limits.

Security

Permissions, secrets, blast radius

Minimum scopes: Google Ads API read/write Meta Marketing API read/write GA4 reporting
Credential storage: OAuth 2.1 — credentials managed server-side, not stored locally
Data egress: Calls to Google Ads API, Meta Marketing API, and Google Analytics Data API
Never grant: Account-level admin access unless you need to create new campaigns

Troubleshooting

Common errors and fixes

OAuth authentication failed

Re-authorize through the setup flow. Ensure your Google/Meta accounts have the required API access enabled.

Verify: Check the server logs for specific OAuth error messages
No data returned from GA4

GA4 data has a 24-48 hour processing delay. For recent data, use realtime reporting.

Verify: Try pulling data from 3+ days ago
Rate limit exceeded

Google Ads and Meta APIs have different rate limits. Reduce query frequency or batch requests.

Verify: Check API quota dashboards in Google/Meta developer consoles

Alternatives

google-meta-ads-ga4-mcp vs others

AlternativeWhen to use it insteadTradeoff
Direct API accessYou need fine-grained control over API parameters not exposed by the MCP toolsMore flexibility but requires writing API code yourself

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills