NestDaddy

Yandex Metrica MCP

io.github.askads/mcp-yandex-metrica · v1.5.5

MCP server for Yandex Metrica API: list counters, goals and pull web-analytics statistics.

Connect Runs on your machine

Terminal
claude mcp add mcp-yandex-metrica -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> -e YANDEX_METRIKA_TIMEOUT_MS=<YANDEX_METRIKA_TIMEOUT_MS> -e YANDEX_METRIKA_MAX_RETRIES=<YANDEX_METRIKA_MAX_RETRIES> -- npx -y [email protected]
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-yandex-metrica": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "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>",
        "YANDEX_METRIKA_TIMEOUT_MS": "<YANDEX_METRIKA_TIMEOUT_MS>",
        "YANDEX_METRIKA_MAX_RETRIES": "<YANDEX_METRIKA_MAX_RETRIES>"
      }
    }
  }
}
~/.cursor/mcp.json
{
  "mcpServers": {
    "mcp-yandex-metrica": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "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>",
        "YANDEX_METRIKA_TIMEOUT_MS": "<YANDEX_METRIKA_TIMEOUT_MS>",
        "YANDEX_METRIKA_MAX_RETRIES": "<YANDEX_METRIKA_MAX_RETRIES>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp-yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "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>",
        "YANDEX_METRIKA_TIMEOUT_MS": "<YANDEX_METRIKA_TIMEOUT_MS>",
        "YANDEX_METRIKA_MAX_RETRIES": "<YANDEX_METRIKA_MAX_RETRIES>"
      }
    }
  }
}

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

NameDescription
YANDEX_METRIKA_TOKEN
Optional, secret
Yandex Metrica OAuth token (scope metrika:read) — read access to analytics data. Treat it as a secret. Optional: without it the server starts anyway and connects through the in-chat login (start_login / finish_login).
YANDEX_METRIKA_OAUTH_CLIENT_ID
Optional
ClientID of your own Yandex OAuth app for the in-chat login. Defaults to the Ask Ads app scoped to metrika:read.
YANDEX_METRIKA_COUNTER_ID
Optional
Default Metrica counter id, used when a tool call omits counterId.
YANDEX_METRIKA_LANG
Optional
Language for API responses (ru, en, ...).
YANDEX_METRIKA_API_BASE
Optional
API root host. Override only for a proxy or a non-default endpoint.
YANDEX_METRIKA_TIMEOUT_MS
Optional
Per-request timeout in milliseconds.
YANDEX_METRIKA_MAX_RETRIES
Optional
Max retries for transient errors (429 rate limit, 5xx on reads).

Details

Package[email protected] (NPM, stdio)
First published1 Nov 2026
Last updated1 Nov 2026
Registry nameio.github.askads/mcp-yandex-metrica

More data and analytics servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.