adsense-mcp

A Model Context Protocol (MCP) server that gives Claude Desktop direct access to your Google AdSense account. Ask plain English questions about your revenue — no dashboard required.

> "How much did I earn this week?" > "Which pages have the best RPM this month?" > "Compare this month vs last month."

---

| Tool | Description | |---|---| | get_earnings_summary | Earnings, page views, impressions, clicks, CTR, RPM for any date range | | get_top_pages | Top pages ranked by earnings, RPM, or impressions | | get_ad_unit_performance | CTR, RPM, and earnings per ad unit | | get_earnings_by_ad_format | Revenue breakdown by format (In-page, Vignette, Anchor, Rewarded, etc.) | | get_earnings_by_traffic_source | Revenue and RPM by traffic source (Google, Bing, Direct, etc.) | | get_country_breakdown | Earnings, RPM, and CTR by country | | get_platform_breakdown | Mobile vs desktop vs tablet earnings and traffic split | | compare_date_ranges | Side-by-side metric comparison with % deltas | | list_alerts | Active AdSense policy issues and account alerts | | get_payments | Payment history sorted by date |

All tools are read-only. No write access to your AdSense account.

---

• Node.js 18+
• A Google AdSense account
• Claude Desktop

---

1. Go to console.cloud.google.com and create a new project (e.g. adsense-mcp-personal)
2. Enable the AdSense Management API for the project
3. Go to APIs & Services → Credentials → Create Credentials → OAuth 2.0 Client ID
4. Choose Desktop app as the application type
5. Download the JSON file and save it as credentials.json in the project root
6. In OAuth consent screen, set the app to Testing mode and add your Gmail as a test user

git clone https://github.com/your-username/adsense-mcp.git
cd adsense-mcp
npm install
npm run build

Run the