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

Google Analytics 4 (6 tools)

Google Search Console (6 tools)

Meta Ads (5 tools)

Google Ads (5 tools)

Related MCP server: google-search-console

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)

3. Create OAuth 2.0 Client ID (Web application type)

4. Add http://localhost:3847/callback as an Authorized redirect URI

5. 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.

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