# admob-mcp-server

Connects the Google AdMob API to your AI agent to inspect revenue, ad units, and mediation statistics.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: ParkSangGwon
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ParkSangGwon/admob-mcp-server
- Updated: 2026-08-03
- HTML: https://affpapa.org/en/nevibecode/mcp/admob-mcp-server

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add admob-mcp-server -- npx -y admob-mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add admob-mcp-server -- npx -y admob-mcp-server
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "admob-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "admob-mcp-server"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "admob-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "admob-mcp-server"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add admob-mcp-server npx -y admob-mcp-server
```

## When to use it
- 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
- 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.

## Similar
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 10025
- [mobilerun](https://affpapa.org/en/nevibecode/mcp/mobilerun.md) — MCP server · ★ 9833
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11962
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6511
- [ShipSwift](https://affpapa.org/en/nevibecode/mcp/shipswift.md) — MCP server · ★ 3244
- [agent-device](https://affpapa.org/en/nevibecode/mcp/agent-device.md) — MCP server · ★ 5158

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md