IO

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

Developer tools
1 тыс. stars 0 forks Качество 95 Тренд 95

Google Ads MCP + Meta Ads MCP + GA4 in one server for Claude, ChatGPT, Cursor & n8n — 250+ tools, hosted remote MCP, OAuth login, no API keys. By Ryze AI.

Обзор

See how to run a full Google Ads and Meta Ads account audit using Claude with MCP — from data pull to automated audit report and presentation, in minutes instead of hours. https://github.com/user-attachments/assets/2f931292-a3af-4010-a72e-38b8cf6e62ba Connect your ad accounts → Claude analyzes campaign performance, budget efficiency, and targeting gaps across Google Ads & Meta Ads → generates a complete audit report with recommendations → builds a ready-to-share presentation. One MCP server. Three platforms. Manage all your advertising and analytics from ChatGPT, Claude, Cursor, n8n, Windsurf, and more. Powered by Ryze AI. Marketers and agencies juggle Google Ads, Meta Ads, and GA4 daily — each with its own dashboard, API, and workflow. Existing MCP servers only cover , forcing you to install and configure multiple tools.

README

Google Ads + Meta Ads + GA4 — MCP Server

The unified MCP server for managing Google Ads, Meta (Facebook/Instagram) Ads, and Google Analytics 4 from any AI assistant.

Watch: Google Ads & Meta Ads Account Audit with Claude MCP

See how to run a full Google Ads and Meta Ads account audit using Claude with MCP — from data pull to automated audit report and presentation, in minutes instead of hours.

https://github.com/user-attachments/assets/2f931292-a3af-4010-a72e-38b8cf6e62ba

What you’ll see: Connect your ad accounts → Claude analyzes campaign performance, budget efficiency, and targeting gaps across Google Ads & Meta Ads → generates a complete audit report with recommendations → builds a ready-to-share presentation. Try it free on Ryze AI →

One MCP server. Three platforms. 250+ tools. Manage all your advertising and analytics from ChatGPT, Claude, Cursor, n8n, Windsurf, and more. Powered by Ryze AI.


Why This Exists

Marketers and agencies juggle Google Ads, Meta Ads, and GA4 daily — each with its own dashboard, API, and workflow. Existing MCP servers only cover one platform at a time, forcing you to install and configure multiple tools.

This server unifies everything:

Problem Solution
Separate MCP servers per platform One server, all platforms
Complex local setup with API keys Remote MCP — connect in 2 minutes
Read-only access (official Google MCP) Full read + write across all platforms
No analytics integration GA4 built-in for data-driven decisions

Works With

AI Assistant Status Setup Guide
ChatGPT Supported Setup Guide
Claude Desktop Supported Setup Guide
Claude Code Supported Setup Guide
Cursor Supported Setup Guide
Windsurf Supported Setup Guide
n8n Supported Setup Guide
Codex CLI Supported Config
Gemini CLI Supported Setup Guide
Cline Supported Setup Guide

Features

  • Campaign Management — Create, update, pause, and delete Search, Display, Shopping, PMax, Demand Gen, Video, and App campaigns
  • Keyword Research — Keyword Planner integration with volume, CPC, and competition data
  • Bidding & Budgets — Portfolio strategies, shared budgets, bid adjustments by device/location/schedule
  • Ad Creation — Responsive Search Ads, Display Ads, Demand Gen Ads, App Ads with full creative control
  • Audience Targeting — Custom audiences, remarketing lists, customer match, combined audiences
  • Performance Analytics — Campaign/ad group/keyword/ad-level metrics, search terms, ROAS calculations
  • Extensions — Sitelinks, callouts, calls, images, prices, promotions, structured snippets, lead forms
  • Experiments — A/B testing with experiment creation, scheduling, and promotion
  • Negative Keywords — Campaign-level, shared sets, auto-suggestions
  • Labels & Organization — Create and apply labels across campaigns, ad groups, and ads
  • Conversion Tracking — Create actions, upload conversions, custom variables, value rules

Meta Ads (80+ tools)

  • Campaign CRUD — Create, read, update, and delete campaigns with full objective support
  • Ad Set Management — Budget, schedule, placement, and optimization controls
  • Creative Management — Ad creatives, image/video upload, carousel and collection formats
  • Audience Targeting — Custom audiences, lookalikes, interest/behavior/demographic targeting
  • Lead Generation — Lead forms, lead retrieval, test leads
  • Product Catalogs — Catalog management, product feeds, product sets
  • Performance Insights — Account/campaign/ad set/ad-level metrics with breakdowns
  • Page Management — Page posts, promotable posts, page insights, boosted posts
  • Business Management — Business info, users, pages, Instagram accounts, pixels

Google Analytics 4 (20+ tools)

  • Reporting — Run standard reports, pivot reports, and realtime reports
  • Audience Analysis — List audiences, channel groups, and segments
  • Property Configuration — Data streams, enhanced measurement, data retention settings
  • Attribution — Attribution settings and model configuration
  • Key Events — List and analyze conversion events
  • Integrations — BigQuery links, DV360 links, Search Ads links, Firebase links
  • Annotations — Property-level annotations for tracking changes
  • Metadata — Available dimensions, metrics, and compatibility checks

Cross-Platform Capabilities

  • Compare Google Ads vs Meta Ads campaign performance side by side
  • Correlate ad spend with GA4 conversion data
  • Unified ROAS analysis across platforms
  • Cross-platform budget allocation recommendations

Quick Start

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "url": "YOUR_MCP_ENDPOINT_URL"
    }
  }
}

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

See the full Claude Setup Guide for detailed instructions.

ChatGPT

  1. Go to Settings > Connectors > Add custom connector
  2. Enter the MCP endpoint URL: YOUR_MCP_ENDPOINT_URL
  3. Name it Google Meta Ads GA4
  4. Click Save

See the full ChatGPT Setup Guide.

Cursor / Windsurf

Add to your MCP config (~/.cursor/mcp.json or ~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "url": "YOUR_MCP_ENDPOINT_URL"
    }
  }
}

n8n

Use the MCP Server Trigger node with Streamable HTTP:

  1. Add an MCP Client node to your workflow
  2. Set the Server URL to: YOUR_MCP_ENDPOINT_URL
  3. Enable Bearer authentication (recommended)

See the full n8n Setup Guide or import the ready-made workflow template.

Claude Code

claude mcp add google-meta-ads-ga4 --transport sse YOUR_MCP_ENDPOINT_URL

Example Prompts

"Show me all my Google Ads campaigns and their performance this month"
"Create a new Search campaign targeting 'best CRM software' keywords with a $50/day budget"
"What are my top 10 keywords by conversions in the last 30 days?"
"Pause all campaigns with ROAS below 2.0"
"Add negative keywords 'free' and 'cheap' to all my Search campaigns"
"Generate keyword ideas for 'project management tools' with volume data"

Meta Ads

"List all active Meta ad campaigns and their spend this week"
"Create a lookalike audience based on my top purchasers"
"What's the CPL for my lead generation campaigns on Facebook?"
"Upload this image and create a new ad creative for my awareness campaign"
"Show me ad performance broken down by age and gender"
"Boost my latest page post with a $100 budget targeting US users"

Google Analytics 4

"Show me a realtime report of active users on my website right now"
"What are my top traffic sources by conversions this month?"
"List all key events configured in my GA4 property"
"Run a report comparing organic vs paid traffic for the last 90 days"
"What custom dimensions and metrics do I have set up?"

Cross-Platform

"Compare my Google Ads and Meta Ads ROAS for Q1 2026"
"Which platform is driving more conversions per dollar spent?"
"Show me all campaigns across Google and Meta with spend over $1000 this month"
"Correlate my GA4 conversion events with Google Ads campaign performance"

Architecture

+------------------+     +------------------------+     +------------------+
|                  |     |                        |     |                  |
|  ChatGPT         |     |                        |     |  Google Ads API  |
|  Claude          |     |   MCP Server           |     |                  |
|  Cursor          +---->+   (Remote/Hosted)       +---->+  Meta Ads API    |
|  n8n             |     |                        |     |                  |
|  Windsurf        |     |   250+ Tools           |     |  GA4 Data API    |
|  Codex           |     |   OAuth 2.1 + PKCE     |     |                  |
|                  |     |                        |     |                  |
+------------------+     +------------------------+     +------------------+
    AI Assistants           Model Context Protocol         Ad & Analytics
                                                            Platforms

Your AI assistant communicates with this MCP server using the Model Context Protocol. The server handles authentication and routes requests to the appropriate Google Ads, Meta Ads, or GA4 API.


All Available Tools


Security & Privacy

  • OAuth 2.1 with PKCE — Industry-standard authentication
  • No data storage — The server does not store your ad data or credentials
  • Your tokens stay local — Authentication tokens are stored on your machine only
  • Read-only by default — Write operations require explicit confirmation
  • Scoped access — Request only the permissions you need

FAQ


Contributing

Contributions are welcome! Please see our issue templates to report bugs or request features.

  1. Fork this repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Star History

If this project helps you manage ads more efficiently, please give it a star! It helps others discover it.


License

This project is licensed under the MIT License — see the LICENSE file for details.


Google Ads MCP · Meta Ads MCP · Facebook Ads MCP · GA4 MCP · Model Context Protocol

Built for marketers, agencies, and developers who want AI-powered ad management.

🚀 Get started with Ryze AI

View this README on GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide

Конфигурация

{ "mcpServers": { "google-meta-ads-ga4": { "url": "YOUR_MCP_ENDPOINT_URL" } } }