Provides tools for interacting with the Google AdMob API to retrieve revenue data, manage publisher accounts, and generate detailed performance reports for apps, ad units, and mediation sources.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AdMob MCP ServerShow me my revenue trend for the last 30 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.shThe setup script will:
Find and rename the Google OAuth JSON to
secrets/client_secret.jsonInstall 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 your AdMob publisher accounts |
| Get details for a specific account |
| List ad units with pagination |
| List apps with pagination |
| Generate a custom network report with full control over dimensions, metrics, filters, and sorting |
| Generate a custom mediation report with full control over dimensions, metrics, filters, and sorting |
Reporting tools
Tool | Prompt example |
| "Show my revenue trend for the last 30 days" |
| "Which ad units are underperforming?" |
| "Break down my earnings by country" |
| "Compare performance across ad formats" |
| "How is iOS vs Android performing?" |
| "What's my fill rate and where am I losing money?" |
| "Which mediation ad sources perform best?" |
| "Show week-over-week revenue changes" |
| "Which apps are my top earners?" |
| "Show my eCPM trends by ad unit over time" |
Revenue optimization tools
Tool | Prompt example |
| "My revenue dropped this week, what happened?" |
| "How much revenue am I losing to privacy restrictions?" |
| "Did my latest app update affect ad revenue?" |
| "Are users on old SDK versions seeing lower eCPM?" |
| "How is this month comparing to last month?" |
| "Which ad placements should I optimize?" |
| "Are certain OS versions hurting my ad revenue?" |
| "Which mediation groups need optimization?" |
| "Where can I improve eCPM 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.jsonDevelopment
npm run build # Compile TypeScript
npm run start # Run the server directly (stdio)This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.