Getting Started

Set up Metrifyr in 5 minutes

Getting Started

Get Metrifyr up and running in under 5 minutes. This guide will walk you through connecting your Google account, setting up the MCP server, and making your first query with Claude.

Prerequisites

• Claude Desktop, Cursor, VS Code, or any MCP-compatible client
• A Google account with access to Analytics, Search Console, or AdSense
• Node.js 18+ (for MCP server)

Step 1: Sign Up

1. Go to metrifyr.cloud/dashboard
2. Sign in with GitHub or Google
3. Complete the onboarding

Takes 30 seconds.

Step 2: Connect Google Account

1. Click "Connect Google" in the dashboard
2. Select which Google services to authorize:
   • ✅ Google Analytics 4 (read-only)
   • ✅ Search Console (read-only)
   • ✅ Google AdSense (read-only)
   • ✅ Tag Manager (edit containers, Beta)
3. Click "Allow" to grant permissions

Your tokens are stored securely and refreshed automatically.

Learn more about OAuth scopes

Step 3: Create API Key

1. Go to Dashboard > API Keys
2. Click "Create API Key"
3. Give it a name (e.g., "Claude Desktop")
4. Select which tools to enable (or select all)
5. Copy your API key - it's only shown once

Store your API key securely. You'll need it for the MCP server configuration.

Learn more about API keys

Step 4: Install MCP Server

Add Metrifyr MCP server to your Claude Desktop (or other MCP client):

Claude Desktop

Edit your Claude Desktop config file:

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

{
  "mcpServers": {
    "metrifyr": {
      "command": "npx",
      "args": ["-y", "@metrifyr/mcp-server@latest"],
      "env": {
        "METRIFYR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / VS Code (Cline Extension)

Add to your Cline MCP settings:

{
  "mcpServers": {
    "metrifyr": {
      "command": "npx",
      "args": ["-y", "@metrifyr/mcp-server@latest"],
      "env": {
        "METRIFYR_API_KEY": "your-api-key-here"
      }
    }
  }
}

More installation options

Step 5: Verify Setup

1. Restart your MCP client (Claude Desktop, Cursor, etc.)
2. Open a new conversation
3. Ask Claude: "List my Google Analytics properties"

You should see a list of your GA4 properties. If you see this, you're all set! 🎉

What's Next?

Common Issues

MCP server not connecting? Make sure you've restarted Claude Desktop after updating the config.

"Unauthorized" error? Check that your API key is correct and hasn't been revoked.

No data showing? Verify your Google account has access to the properties you're querying.

See full troubleshooting guide