@fullqueso/mcp-googleanalytics

Google Analytics 4 MCP server for Full Queso — digital channel intelligence for fullqueso.com and somos.fullqueso.com.

Tools

| Tool | Description | |------|-------------| | get_traffic_overview | Sessions, users, bounce rate by channel | | get_delivery_app_funnel | Conversion funnel: session > menu > cart > checkout > purchase | | get_top_pages | Top / landing / exit pages with engagement metrics | | get_traffic_sources | Channel breakdown with Instagram attribution | | get_device_breakdown | Mobile vs desktop vs tablet | | get_unified_marketing_dashboard | GA4 + Meta Ads combined view | | get_realtime_overview | Live active users and active pages |

Quick Start

1. Install

npm install -g @fullqueso/mcp-googleanalytics

2. Set up credentials

Place the GA4 service account JSON key file somewhere secure on your machine (e.g. ~/.secrets/fullqueso-ga-service-account.json). The service account must have Viewer access on the GA4 property.

3. Add to Claude Desktop

Add the following to your claude_desktop_config.json:

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

{
  "mcpServers": {
    "fullqueso-googleanalytics": {
      "command": "npx",
      "args": ["-y", "@fullqueso/mcp-googleanalytics"],
      "env": {
        "GA_PROPERTY_ID": "350429084",
        "GA_STREAM_ID_MAIN": "4443190758",
        "GA_STREAM_ID_LANDING": "11236115740",
        "GA_KEY_FILE": "/path/to/fullqueso-ga-service-account.json"
      }
    }
  }
}

Replace /path/to/fullqueso-ga-service-account.json with the actual path to the service account key on your machine.

4. Optional: Meta Ads integration

To enable get_unified_marketing_dashboard with blended GA4 + Meta Ads metrics, add these env vars:

"META_ACCESS_TOKEN": "your-meta-access-token",
"META_AD_ACCOUNT_ID": "act_your_account_id"

Without Meta credentials, Tool 6 will return GA4 data only (Meta section returns null).

Properties

• fullqueso.com — Delivery web app (stream ID: 4443190758)
• somos.fullqueso.com — Brand landing page (stream ID: 11236115740)
• GA4 Property ID: 350429084

Version History

See CHANGELOG.md