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

Related MCP server: Yandex Metrika MCP

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

Available Tools

Management

Reporting

Logs

Push Notifications

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