# appmetrica-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/pavellunev/app_metrica_mcp  
**GitHub Stars:** 3  
**npm Downloads (last month):** 763  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/appmetrica-mcp

## Description
AppMetrica (Yandex) analytics: reports, funnels, segments, dashboards, logs export, push

## Tools
Capabilities this server exposes over MCP:

- **list_applications** — List all AppMetrica applications in your account
- **get_application** — Get details for a specific application by ID
- **list_events** — List client event names of an application (use them as funnel steps)
- **list_conversions** — List configured conversions (attributed events)
- **get_logs_api_status** — Check whether the Logs API is enabled for the account
- **get_report** — Aggregated metrics for a date range, with `filters`, `sort`, `segment_id`, `currency`, `accuracy`, `include_undefined`, `lang`, `offset
- **get_report_bytime** — The same as a time series (`group`: day / week / month / hour / all). One namespace prefix per call
- **get_drilldown** — Drill down into a dimension value for detailed breakdown
- **list_metrics** — Metric/dimension catalogue (197 metrics, 188 dimensions): compact overview, or `search` / `namespace` / `kind` / `limit` for entries
- **audit_events** — Event instrumentation audit for a period: registered vs active vs zero-volume events, optional `expected_events`, plain-language findings (read-only)
- **list_segments** — List saved segments (id, name, expression)
- **get_segment** — Get one segment with all fields
- **list_funnels** — List saved funnels with decoded steps and options
- **get_funnel_report** — Per-step devices and conversion for a saved funnel (`funnel_id`) or ad-hoc `steps
- **get_dashboard** — Run preset widgets (`widgets`) or a saved workspace (`workspace`) for a date range
- **list_dashboard_presets** — List preset widgets with their metrics
- **list_workspaces** — List locally saved workspaces
- **get_workspace** — Get a workspace with its widget specs
- **save_workspace** — Create or update a local workspace (local file only)
- **delete_workspace** — Delete a local workspace (local file only)
- **web_session_status** — Check the web session: logged in, Yandex login, profile directory
- **web_list_workspaces** — List the app's AppMetrica workspaces (system + custom)
- **web_get_workspace** — One workspace: groups, headers and widgets with names, metrics, dimensions
- **web_list_widget_presets** — Web preset widgets (`widget_id` = `preset` value), optional `category
- **web_list_report_namespaces** — Report namespaces with their Reporting API prefix; with `namespace_id` the valid metrics and dimensions
- **web_create_workspace** — Create a workspace with `groups` (`{header?, widgets?}`) in one call
- **web_add_widgets** — Add a row of widgets to a workspace (`position` optional)
- **web_add_header** — Add a section header row
- **web_rename_workspace** — Rename a workspace
- **web_remove_widget** — Remove a widget by `dashboard_widget_id
- **web_delete_workspace** — Delete a custom workspace (system `<appId>/…` dashboards are refused)
- **web_push_workspace** — Create an AppMetrica workspace from a local one (`workspace`, optional `name`)
- **export_events** — Export raw custom event logs
- **export_crashes** — Export raw crash logs
- **export_installations** — Export raw installation logs
- **export_logs** — Export any Logs API table (13 tables), with field validation; `push_tokens` needs no dates
- **list_push_campaigns** — List push notification campaigns with optional status filter
- **get_push_stats** — Get delivery statistics for a campaign
- **create_push_campaign** — Create a push campaign (requires `APPMETRICA_ALLOW_WRITE=true`)
- **create_funnel** — Create a saved funnel (`name`, `steps`, `comment`, `foreground_only`, `single_session`, `events_between_steps`)
- **update_funnel** — Rename / re-comment a funnel, or rebuild its steps and options (the rest of the saved funnel is kept)
- **delete_funnel** — Delete a saved funnel
- **create_segment** — Create a segment from `events` (users who did all of them)
- **update_segment** — Change a segment's `name` and/or `events
- **delete_segment** — Delete a segment

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "appmetrica-mcp": {
    "command": "npx",
    "args": ["-y","appmetrica-mcp"]
  }
}
```

## Documentation

## What appmetrica-mcp MCP server does

The appmetrica-mcp MCP server exposes Yandex AppMetrica data and selected management operations as MCP tools. It can enumerate applications, retrieve application details, inspect client event names and configured conversions, and check whether the Logs API is available for the account.

Reporting tools cover aggregated metrics over a date range, time-series grouping by hour, day, week, or month, and dimension drilldowns. Reports accept options such as filters, sorting, segments, currency, accuracy, undefined-value handling, language, and pagination. A metric and dimension catalogue supports compact listing and filtered searches across the available definitions.

The server also includes tools for saved segments and funnels, ad-hoc funnel steps, funnel conversion results, dashboard presets, locally stored workspaces, and event instrumentation audits. The audit compares registered events with observed activity and can identify zero-volume or missing events for a selected period.

## How it works

An MCP client starts the server, which calls AppMetrica APIs using a Yandex OAuth token. Read operations are available for account and application analytics. Write actions are protected by a setting that must be enabled explicitly; the README identifies push campaign creation and funnel or segment changes as write operations.

Local workspaces are represented as JSON data on the server’s filesystem. These differ from AppMetrica’s web workspaces. The `web_*` tools use an experimental logged-in Chrome session to inspect or modify AppMetrica workspaces, including their groups, headers, and widgets. This browser path is separate from the API-based reporting and management functions.

## Setup and configuration

The appmetrica-mcp MCP server requires Node.js 22 or newer, an AppMetrica account with at least one application, and Yandex authorization. The recommended authentication command is `npx appmetrica-mcp auth`; it stores credentials locally for later server runs. An OAuth token can instead be supplied directly with `APPMETRICA_OAUTH_TOKEN`.

The standard installation pattern runs the package with `npx -y appmetrica-mcp`, including from Claude Code or Claude Desktop. `APPMETRICA_ALLOW_WRITE=true` enables supported write tools; its default is false. `APPMETRICA_WORKSPACES_FILE` changes the location of locally saved workspaces.

The experimental web tools additionally need Google Chrome or another configured Chromium-compatible browser and a one-time `npx appmetrica-mcp login`. Browser profile and executable settings can be controlled with `APPMETRICA_BROWSER_PROFILE`, `APPMETRICA_BROWSER_PATH`, and `APPMETRICA_BROWSER_CHANNEL`.

## Tools and capabilities

Available capabilities include:

- Listing applications, events, conversions, segments, funnels, dashboard presets, workspaces, and report namespaces.
- Running reports, time series, drilldowns, saved or ad-hoc funnel reports, and metric catalogue searches.
- Checking Logs API status and auditing event instrumentation over a selected period.
- Reading and changing locally saved workspace definitions.
- Reading and editing AppMetrica web workspaces through the experimental browser session.

## Limitations and notes

The server depends on AppMetrica account access and a valid Yandex OAuth authorization. Logs-related operations require the account’s Logs API availability. Browser workspace features are experimental and require a separate logged-in browser session. Write operations remain disabled unless explicitly enabled, so read-only behavior is the default.

_Full upstream README: https://allmcps.com/mcp/appmetrica-mcp/readme_