# Yandex Metrica MCP

Yandex Metrica MCP is a Claude Code MCP server that retrieves website analytics from Yandex Metrica. Ask about traffic, goals, or conversions in chat to get data from a counter.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: askads
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/askads/mcp-yandex-metrica
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/askads-yandex-metrica-mcp

## What it does

Yandex Metrica MCP connects an assistant to Yandex Metrica counters. It can find counters and goals available to an account, then return reports for a selected period covering visits, users, page views, bounce rate, visit duration, and traffic sources. Its dedicated reporting tools are read-only.

The server runs through `npx` and requires Node.js 20 or later. Claude Code setup uses the `YANDEX_METRIKA_TOKEN` environment variable. Reports can also indicate when Yandex Metrica applies sampling or when a result reaches an output limit.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `YANDEX_METRIKA_TOKEN`, `YANDEX_METRIKA_OAUTH_CLIENT_ID`, `YANDEX_METRIKA_COUNTER_ID`, `YANDEX_METRIKA_LANG`, `YANDEX_METRIKA_API_BASE`, `YANDEX_METRIKA_TIMEOUT_MS`, `YANDEX_METRIKA_MAX_RETRIES` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> --env YANDEX_METRIKA_OAUTH_CLIENT_ID=<YANDEX_METRIKA_OAUTH_CLIENT_ID> --env YANDEX_METRIKA_COUNTER_ID=<YANDEX_METRIKA_COUNTER_ID> --env YANDEX_METRIKA_LANG=<YANDEX_METRIKA_LANG> --env YANDEX_METRIKA_API_BASE=<YANDEX_METRIKA_API_BASE> --transport stdio askads-yandex-metrica-mcp -- npx -y mcp-yandex-metrica
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add askads-yandex-metrica-mcp --env YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> --env YANDEX_METRIKA_OAUTH_CLIENT_ID=<YANDEX_METRIKA_OAUTH_CLIENT_ID> --env YANDEX_METRIKA_COUNTER_ID=<YANDEX_METRIKA_COUNTER_ID> --env YANDEX_METRIKA_LANG=<YANDEX_METRIKA_LANG> --env YANDEX_METRIKA_API_BASE=<YANDEX_METRIKA_API_BASE> -- npx -y mcp-yandex-metrica
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "askads-yandex-metrica-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-yandex-metrica"
            ],
            "env": {
                "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>",
                "YANDEX_METRIKA_OAUTH_CLIENT_ID": "<YANDEX_METRIKA_OAUTH_CLIENT_ID>",
                "YANDEX_METRIKA_COUNTER_ID": "<YANDEX_METRIKA_COUNTER_ID>",
                "YANDEX_METRIKA_LANG": "<YANDEX_METRIKA_LANG>",
                "YANDEX_METRIKA_API_BASE": "<YANDEX_METRIKA_API_BASE>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "askads-yandex-metrica-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-yandex-metrica"
            ],
            "env": {
                "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>",
                "YANDEX_METRIKA_OAUTH_CLIENT_ID": "<YANDEX_METRIKA_OAUTH_CLIENT_ID>",
                "YANDEX_METRIKA_COUNTER_ID": "<YANDEX_METRIKA_COUNTER_ID>",
                "YANDEX_METRIKA_LANG": "<YANDEX_METRIKA_LANG>",
                "YANDEX_METRIKA_API_BASE": "<YANDEX_METRIKA_API_BASE>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -e YANDEX_METRIKA_OAUTH_CLIENT_ID=<YANDEX_METRIKA_OAUTH_CLIENT_ID> -e YANDEX_METRIKA_COUNTER_ID=<YANDEX_METRIKA_COUNTER_ID> -e YANDEX_METRIKA_LANG=<YANDEX_METRIKA_LANG> -e YANDEX_METRIKA_API_BASE=<YANDEX_METRIKA_API_BASE> askads-yandex-metrica-mcp npx -y mcp-yandex-metrica
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- track visits and users across a date range
- compare traffic sources by bounce rate and conversions
- find accessible counters and configured goals
- check whether a report uses sampled data

## Example prompts
- Show site visits and users for the past week.
- Compare traffic sources by bounce rate for last month.
- Which goals are available in my Yandex Metrica counter?

## Similar
- [yandex-metrica-mcp](https://affpapa.org/en/nevibecode/mcp/yandex-metrica-mcp.md) — MCP server · ★ 16 repo stars
- [Yandex Metrika](https://affpapa.org/en/nevibecode/mcp/yandex-metrika.md) — MCP server · ★ 130 repo stars
- [Yandex Tools MCP](https://affpapa.org/en/nevibecode/mcp/yandex-tools-mcp.md) — MCP server · ★ 71 repo stars
- [Marketplaces MCP (RU) — Wildberries, Ozon, Yandex Market, Avito](https://affpapa.org/en/nevibecode/mcp/marketplaces-mcp-ru-wildberries-ozon-yandex-market-avito.md) — MCP server · ★ 63 repo stars
- [yandex-lavka-mcp](https://affpapa.org/en/nevibecode/mcp/yandex-lavka-mcp.md) — MCP server · ★ 28 repo stars
- [Yandex Wordstat MCP](https://affpapa.org/en/nevibecode/mcp/yandex-wordstat-mcp.md) — MCP server · ★ 21 repo stars

---
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
