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?" |
Project structure
admob-mcp/
├── src/
│ ├── index.ts # MCP server and tool definitions
│ ├── auth.ts # OAuth 2.0 flow with local redirect server
│ ├── admob-client.ts # AdMob REST API client
│ └── helpers.ts # Date utilities, report parsing, table formatting
├── secrets/ # Git-ignored; holds credentials and tokens
├── setup.sh # One-command setup script
├── package.json
└── tsconfig.json
Development
npm run build # Compile TypeScript
npm run start # Run the server directly (stdio)