appmetrica-mcp

MCP server for AppMetrica — Yandex's mobile analytics platform. Gives Claude direct access to your app's analytics: reports, raw event logs, crash data, and push notification campaigns.

Features

• Reporting API — aggregated metrics (users, sessions, revenue, retention) with dimension breakdowns
• Logs API — raw event, crash, and installation exports
• Management API — list and inspect your AppMetrica applications
• Push API — view campaigns and statistics; create campaigns when write mode is enabled
• Safe by default — write operations are disabled unless you explicitly opt in

Requirements

• Node.js 22+
• An AppMetrica account with at least one application
• A Yandex OAuth token (see below)

Getting an OAuth Token

AppMetrica uses Yandex OAuth. Use the Russian OAuth portal (oauth.yandex.ru) — the international version (oauth.yandex.com) does not expose AppMetrica scopes in its UI.

Step 1 — Create an OAuth app

1. Go to oauth.yandex.ru/client/new
2. Fill in any name (e.g. AppMetrica MCP)
3. Under Platforms, select Web services and set the Callback URI to:

   https://oauth.yandex.ru/verification_code
   

4. Under Доступы (Access), find the AppMetrica section and enable:
   • Чтение данных AppMetrica — read access (required)
   • Запись данных AppMetrica — write access (optional, needed for push campaign creation)
5. Click Создать приложение and copy the ClientID

Step 2 — Get a token

Open this URL in your browser (replace CLIENT_ID with your app's ID):

https://oauth.yandex.ru/authorize?response_type=token&client_id=CLIENT_ID

Log in → authorize the app → copy the access_token value from the redirect URL.

Note: The token does not expire by default. You can revoke it anytime at passport.yandex.ru/profile/access.

Installation

Claude Code (recommended)

claude mcp add appmetrica \
  -e APPMETRICA_OAUTH_TOKEN=your_token \
  -- npx -y appmetrica-mcp

To enable write operations (push campaign creation):

claude mcp add appmetrica \
  -e APPMETRICA_OAUTH_TOKEN=your_token \
  -e APPMETRICA_ALLOW_WRITE=true \
  -- npx -y appmetrica-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "appmetrica": {
      "command": "npx",
      "args": ["-y", "appmetrica-mcp"],
      "env": {
        "APPMETRICA_OAUTH_TOKEN": "your_token"
      }
    }
  }
}

Building from source

git clone https://github.com/pavellunev99/app_metrica_mcp
cd app_metrica_mcp
npm install
npm run build

Configuration

Variable	Required	Default	Description
APPMETRICA_OAUTH_TOKEN	Yes	—	Yandex OAuth token with AppMetrica scope
APPMETRICA_ALLOW_WRITE	No	false	Set to true to enable push campaign creation

Available Tools

Management

Tool	Description
list_applications	List all AppMetrica applications in your account
get_application	Get details for a specific application by ID

Reporting

Tool	Description
get_report	Fetch aggregated metrics for a date range (users, sessions, crashes, etc.)
get_drilldown	Drill down into a dimension value for detailed breakdown
list_metrics	List available metric keys with descriptions

Logs

Tool	Description
export_events	Export raw custom event logs
export_crashes	Export raw crash logs
export_installations	Export raw installation logs

Push Notifications

Tool	Access	Description
list_push_campaigns	Read	List push notification campaigns with optional status filter
get_push_stats	Read	Get delivery statistics for a campaign
create_push_campaign	Write	Create a push campaign (requires APPMETRICA_ALLOW_WRITE=true)

Usage Examples

Once connected, you can ask Claude things like:

• "List my AppMetrica applications"
• "Show DAU and sessions for app 12345 over the last 7 days"
• "Export crash logs for app 12345 from 2024-01-01 to 2024-01-07"
• "What push campaigns are currently active for app 12345?"
• "Show me new user counts broken down by app version"

Rate Limits

AppMetrica enforces the following limits on all API requests:

• 30 requests / second per OAuth token
• 5,000 requests / day per OAuth token

The client retries automatically on 429 and 5xx responses with exponential backoff (1s → 2s → 4s, up to 3 attempts).

License

MIT