admob-mcp-server — Claude Code MCP server: how to install
Connects the Google AdMob API to your AI agent to inspect revenue, ad units, and mediation statistics.
claude mcp add admob-mcp-server -- npx -y admob-mcp-serverWhat admob-mcp-server does
The server links your AI assistant to the Google AdMob v1beta API over stdio. It exposes 9 read-only tools organized into accounts, apps, ad units, reports, and mediation groups. When the API returns streaming report chunks, the server flattens them into tabular rows and converts micro-amounts into standard currency values.
Data and tokens move directly between your local machine and Google servers without intermediate hosts. You can sign in via a browser using npx admob-mcp-server auth, provide a refresh token through environment variables, or rely on gcloud Application Default Credentials. Tools can be filtered at launch by passing specific toolset names.
Running the tool requires Node.js 18 or newer and an active Google Cloud project with the AdMob API enabled. Without downloading a Desktop OAuth client credential file to ~/.admob-mcp/oauth_client.json, local authorization will fail. All operations request read-only scopes. It cannot modify your account.
What it helps with
- Check daily and weekly ad earnings grouped by country
- Evaluate eCPM metrics across mediation ad sources
- Inspect inventory configurations and attached ad units
- Review RPM differences between rewarded and banner formats
Example prompts for the agent
- How much did my apps earn during the past 7 days by country?
- Which mediation ad network delivered the highest eCPM this month?
- List all registered AdMob apps alongside their active ad units.
How to install admob-mcp-server
Platform CLI
claude mcp add admob-mcp-server -- npx -y admob-mcp-serverPlatform CLI
codex mcp add admob-mcp-server -- npx -y admob-mcp-serverConfig file
{
"mcpServers": {
"admob-mcp-server": {
"command": "npx",
"args": [
"-y",
"admob-mcp-server"
]
}
}
}Config file
{
"servers": {
"admob-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"admob-mcp-server"
]
}
}
}Platform CLI
gemini mcp add admob-mcp-server npx -y admob-mcp-serverStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about admob-mcp-server
How to install admob-mcp-server in Claude Code?
Run claude mcp add admob-mcp-server -- npx -y admob-mcp-server. Before connecting, place your Google Cloud OAuth client credentials in ~/.admob-mcp/oauth_client.json and authenticate via npx admob-mcp-server auth.
What does admob-mcp-server do?
It lets your AI agent query revenue stats, inspect mediation performance, and retrieve ad unit details. The server formats raw streaming responses into readable tables with standard currency values.
Can this MCP server change settings in my AdMob account?
No, the tool operates strictly in read-only mode. It requests only admob.readonly and admob.report scopes during login, so write operations are impossible.
