Skip to main content
Glama
willhou

AdMob MCP Server

by willhou

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

  1. Go to the Google API Console

  2. Create or select a project

  3. Enable the AdMob API in the API Library

  4. Go to Credentials > Create Credentials > OAuth client ID

  5. Select Desktop app, name it, and click Create

  6. Click Download JSON to download the client secret file

  7. 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)
-
security - not tested
A
license - permissive license
-
quality - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/willhou/admob-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server