AdSense-MCP-Server

Google AdSense MCP Server — Connect Google AdSense to Claude, Cursor, and other MCP clients.

Features

• 📊 Earnings Summary — Quick overview of today, yesterday, last 7 days, and monthly earnings
• 📈 Detailed Reports — Generate reports with dimensions (date, site, country, ad unit) and metrics
• 🔄 Period Comparison — Compare performance between time periods
• 🌐 Site Status — Check approval status for all your sites
• ⚠️ Alerts & Policy Issues — Monitor account health and catch violations early
• 💰 Payment History — View payment history and pending earnings
• 📦 Ad Units — List ad units and get embed codes
• 📤 CSV Export — Export reports for further analysis
• 💾 Caching — SQLite cache for faster repeated queries
• 🔐 Secure — OAuth tokens stored in OS keychain, read-only scope

Quick Start

# Install globally
npm install -g @appsyogi/adsense-mcp-server

# Set up OAuth credentials
adsense-mcp init

# Verify setup
adsense-mcp doctor

# Start the server (for MCP clients)
adsense-mcp run

Prerequisites

1. Create Google Cloud OAuth Credentials

You need to create your own OAuth credentials in Google Cloud Console:

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the AdSense Management API:
   • Go to “APIs & Services” → “Library”
   • Search for “AdSense Management API”
   • Click “Enable”
4. Create OAuth credentials:
   • Go to “APIs & Services” → “Credentials”
   • Click “Create Credentials” → “OAuth client ID”
   • Choose “Desktop application”
   • Name it (e.g., “AdSense-MCP”)
   • Click “Create”
5. Copy the Client ID and Client Secret
6. Add test users (required while app is in testing mode):
   • Go to “APIs & Services” → “OAuth consent screen”
   • Scroll to “Test users” section
   • Click “Add users”
   • Add the Google account email(s) you’ll use to authenticate
   • Click “Save”

Note: While your app’s publishing status is “Testing”, only test users can authenticate. You can add up to 100 test users.

2. Configure AdSense-MCP

Run the init command and enter your credentials:

adsense-mcp init

This will:

• Prompt for your Client ID and Client Secret
• Open a browser for Google authentication
• Store your refresh token securely in the OS keychain

Installation