mcp-marketing-analytics

Marketing Analytics MCP Server

A Model Context Protocol (MCP) server that gives Claude access to Google Analytics 4, Google Search Console, Meta Ads, and Google Ads. Ask Claude about your marketing data in natural language.

Tools (23 total)

Setup

| Tool | Description | |------|-------------| | setup_guide | Step-by-step setup instructions — shows what's configured and guides you through any missing API credentials |

Google Analytics 4 (6 tools)

| Tool | Description | |------|-------------| | ga4_list_accounts | List all GA4 properties accessible to your Google account | | ga4_run_report | Run a custom report with any dimensions/metrics | | ga4_realtime_report | See active users right now | | ga4_top_pages | Most viewed pages | | ga4_traffic_sources | Traffic by source/medium | | ga4_user_metrics | Summary with optional period-over-period comparison |

Google Search Console (6 tools)

| Tool | Description | |------|-------------| | gsc_list_sites | List all Search Console sites you have access to | | gsc_search_analytics | Flexible search analytics query | | gsc_top_queries | Top search queries by clicks | | gsc_top_pages | Top pages in search results | | gsc_inspect_url | Check indexing status of any URL | | gsc_list_sitemaps | List submitted sitemaps |

Meta Ads (5 tools)

| Tool | Description | |------|-------------| | meta_list_ad_accounts | List accessible ad accounts | | meta_account_overview | Account-level spend/performance | | meta_campaign_insights | Campaign metrics | | meta_adset_insights | Ad set metrics | | meta_ad_insights | Individual ad metrics |

Google Ads (5 tools)

| Tool | Description | |------|-------------| | gads_query | Execute raw GAQL queries | | gads_campaign_performance | Campaign performance metrics | | gads_keyword_performance | Keyword metrics + quality score | | gads_ad_group_performance | Ad group metrics | | gads_account_summary | Account totals + top campaigns |

Quick Start

1. Clone and build

git clone https://github.com/YOUR_USERNAME/mcp-marketing-analytics.git
cd mcp-marketing-analytics
npm install
npm run build

2. Get your credentials

Run the interactive setup wizard:

npm run setup

Or manually create a .env file (see .env.example).

Google APIs (GA4 + Search Console + Google Ads)

1. Go to Google Cloud Console
2. Create a project and enable:

• Google Analytics Data API
• Google Analytics Admin API
• Google Search Console API
• Google Ads API (optional)

1. Create OAuth 2.0 Client ID (Web application type)
2. Add http://localhost:3847/callback as an Authorized redirect URI
3. Run npm run setup to complete the OAuth flow and get your refresh token

Meta Ads (optional)

1. Go to Meta Graph API Explorer
2. Generate a token with ads_read permission
3. Exchange for a long-lived token (60-day expiry)

Google Ads (optional)

1. Create a Manager Account
2. Get a Developer Token from Tools & Settings → API Center
3. Note your Customer Account ID (10 digits)

3. Add to Claude Desktop

Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

{
  "mcpServers": {
    "marketing-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-marketing-analytics/dist/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

4. Add to Claude Code

claude mcp add marketing-analytics -- node "/absolute/path/to/mcp-marketing-analytics/dist/index.js"

5. Restart Claude and start asking

• "List my GA4 properties"
• "Show me top pages for the last 30 days"
• "What are my top search queries on Google?"
• "How are my Meta ad campaigns performing?"
• "Compare this month's traffic to last month"

Configuration

All API credentials are passed via environment variables. Only configure the APIs you need — unconfigured APIs will show a helpful message instead of crashing.

| Variable | Required | Description | |----------|----------|-------------| | GOOGLE_CLIENT_ID | For Google APIs | OAuth 2.0 Client ID | | GOOGLE_CLIENT_SECRET | For Google APIs | OAuth 2.0 Client Secret | | GOOGLE_REFRESH_TOKEN | For Google APIs | OAuth 2.0 Refresh Token | | GA4_PROPERTY_ID | No | Default GA4 property (can be set per-request) | | GSC_SITE_URL | No | Default GSC site (can be set per-request) | | META_ACCESS_TOKEN | For Meta Ads | Long-lived access token | | META_APP_ID | No | For app secret proof | | META_APP_SECRET | No | For app secret proof | | GOOGLE_ADS_DEVELOPER_TOKEN | For Google Ads | From API Center | | GOOGLE_ADS_CUSTOMER_ID | For Google Ads | 10-digit account ID | | GOOGLE_ADS_LOGIN_CUSTOMER_ID | No | MCC manager account ID |

Multi-Account Support

You don't need to hardcode property IDs or site URLs. Use the discovery tools:

1. ga4_list_accounts → shows all GA4 properties you can access
2. gsc_list_sites → shows all Search Console sites you can access
3. Pass propertyId or siteUrl to any tool to query a specific account

License

MIT