README.md
Connects Claude to the Google AdMob API for ad revenue data analysis.
AdMob MCP Server
A local Model Context Protocol server that connects Claude to the Google AdMob API, giving you a conversational interface to your ad revenue data.
Prerequisites
- Node.js 18+
- A Google Cloud project with the AdMob API enabled
- OAuth 2.0 credentials (Desktop app type) downloaded from the Google API Console
Setup
1. Get Google OAuth credentials
- Go to the Google API Console
- Create or select a project
- Enable the AdMob API in the API Library
- Go to Credentials > Create Credentials > OAuth client ID
- Select Desktop app, name it, and click Create
- Click Download JSON to download the client secret file
- Copy the downloaded file into the
secrets/folder in this project
2. Install and configure
cd admob-mcp
./setup.sh
The setup script will:
- Find and rename the Google OAuth JSON to
secrets/client_secret.json - Install dependencies and build
- Open a browser for Google OAuth authorization (token saved to
secrets/token.json) - Register the MCP server with Claude Code
Note: If your Google Cloud project's OAuth consent screen has not been published (i.e. it is still in "Testing" status), you will see an authorization error. To fix this, either publish the app or add your Google account as a test user under OAuth consent screen > Audience in the Google Cloud Console.
Manual configuration
If you prefer not to use setup.sh, add this to your Claude Code MCP config:
{
"mcpServers": {
"admob": {
"type": "stdio",
"command": "node",
"args": ["/absolute/path/to/admob-mcp/dist/index.js"],
"env": {
"ADMOB_CREDENTIALS_PATH": "/absolute/path/to/admob-mcp/secrets/client_secret.json"
}
}
}
}
Usage
Just ask Claude a question about your AdMob data in natural language. On first use, Claude will automatically call list_accounts to discover your AdMob accounts and ask which one you want to work with. After that, it will use the appropriate tools to answer your questions.
Tools
Core API tools
| Tool | Description |
|---|---|
list_accounts |
List your AdMob publisher accounts |
get_account |
Get details for a specific account |
list_ad_units |
List ad units with pagination |
list_apps |
List apps with pagination |
generate_network_report |
Generate a custom network report with full control over dimensions, metrics, filters, and sorting |
generate_mediation_report |
Generate a custom mediation report with full control over dimensions, metrics, filters, and sorting |
Reporting tools
| Tool | Prompt example |
|---|---|
revenue_trend |
"Show my revenue trend for the last 30 days" |
ad_unit_performance |
"Which ad units are underperforming?" |
country_breakdown |
"Break down my earnings by country" |
format_comparison |
"Compare performance across ad formats" |
platform_comparison |
"How is iOS vs Android performing?" |
fill_rate_analysis |
"What's my fill rate and where am I losing money?" |
mediation_ad_source_performance |
"Which mediation ad sources perform best?" |
wow_revenue |
"Show week-over-week revenue changes" |
top_apps |
"Which apps are my top earners?" |
ecpm_trend |
"Show my eCPM trends by ad unit over time" |
Revenue optimization tools
| Tool | Prompt example |
|---|---|
revenue_drop_diagnosis |
"My revenue dropped this week, what happened?" |
serving_restriction_impact |
"How much revenue am I losing to privacy restrictions?" |
app_version_impact |
"Did my latest app update affect ad revenue?" |
sdk_version_check |
"Are users on old SDK versions seeing lower eCPM?" |
month_over_month |
"How is this month comparing to last month?" |
high_impression_low_ctr |
"Which ad placements should I optimize?" |
os_version_performance |
"Are certain OS versions hurting my ad revenue?" |
mediation_group_analysis |
"Which mediation groups need optimization?" |
country_ecpm_opportunity |
"Where can I improve eCPM by country?" |
format_by_country |
"Which ad formats work best in which countries?" |
revenue_pacing |
"Am I on track to hit last month's revenue?" |
best_worst_days |
"What were my best and worst days this month?" |
weekday_vs_weekend |
"Do I earn more on weekdays or weekends?" |
platform_format_matrix |
"Which formats perform best on each platform?" |
revenue_concentration |
"How diversified is my revenue?" |
ad_source_trend |
"How are my mediation sources trending?" |
app_deep_dive |
"Give me a full breakdown for my top app" |
anomaly_detection |
"Flag any unusual days in the last 30 days" |
| ` |
Tools (6)
list_accountsList your AdMob publisher accountsget_accountGet details for a specific accountlist_ad_unitsList ad units with paginationlist_appsList apps with paginationgenerate_network_reportGenerate a custom network report with full control over dimensions, metrics, filters, and sortinggenerate_mediation_reportGenerate a custom mediation report with full control over dimensions, metrics, filters, and sortingEnvironment Variables
ADMOB_CREDENTIALS_PATHrequiredAbsolute path to the Google OAuth client_secret.json fileConfiguration
claude_desktop_config.json
{"mcpServers": {"admob": {"type": "stdio", "command": "node", "args": ["/absolute/path/to/admob-mcp/dist/index.js"], "env": {"ADMOB_CREDENTIALS_PATH": "/absolute/path/to/admob-mcp/secrets/client_secret.json"}}}}Try it
→Show my revenue trend for the last 30 days
→Which ad units are underperforming?
→Break down my earnings by country
→My revenue dropped this week, what happened?
→Which apps are my top earners?