Skip to content
MCP server

Yandex Metrika

Read-only Yandex Metrika analytics for AI clients, with checkable dates and exports

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
1.0.0
Listing updated
today

Similar MCP servers

About Yandex Metrika

Yandex Metrika is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

This server answers traffic questions from Yandex Metrika counters and shows its working. Each answer carries exact dates, the counter's time zone, sampling status, filters and provenance. By default it uses complete calendar days, and strict accuracy mode refuses sampled data rather than calling it exact. Totals come from the API rather than summed visible rows.

Thirteen tools and three prompts cover it: metrika_connect starts a browser sign-in with no token pasted into chat, metrika_list_counters and metrika_describe_counter show sites and goals, metrika_run_report, metrika_compare_periods and metrika_run_timeseries do the analysis, and the export tools run full CSV or JSON exports as resumable background jobs with checksums. The prompts are weekly_review, traffic_drop and landing_conversion. A synthetic demo connection works without an account.

Tokens are kept in the operating system credential store, report data you request goes to your AI client's model provider, and there is no telemetry. It needs Node.js 22.13 or later. The README says 1.0.0 was checked with a live Yandex sign-in on macOS, with other platforms still tracked. Documentation is available in Russian.

Install

Run in a terminal

claude mcp add yandex-metrika-mcp --env YANDEX_METRIKA_TOKEN='<YANDEX_METRIKA_TOKEN>' -- npx -y @dev-crabs/yandex-metrika-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "yandex-metrika-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dev-crabs/yandex-metrika-mcp"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "yandex-metrika-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dev-crabs/yandex-metrika-mcp"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "yandex-metrika-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dev-crabs/yandex-metrika-mcp"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "yandex-metrika-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dev-crabs/yandex-metrika-mcp"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "yandex-metrika-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@dev-crabs/yandex-metrika-mcp"
      ],
      "env": {
        "YANDEX_METRIKA_TOKEN": "<YANDEX_METRIKA_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • YM_MCP_CLIENT_IDOptional: your own Yandex OAuth app client ID (public PKCE client, no secret).
  • YANDEX_METRIKA_TOKENOptional: an existing OAuth token with metrika:read, for headless setups.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

metrika_status
Shows connections, exports and the next step.
metrika_connect
Starts a browser sign-in.
metrika_disconnect
Removes a connection and its token locally.
metrika_list_counters
Lists counters.
metrika_describe_counter
Describes a counter's time zone and goals.
metrika_catalog
Lists presets, metrics, dimensions and period presets.
metrika_run_report
Runs a report for one period.
metrika_compare_periods
Compares two periods under identical conditions.
metrika_run_timeseries
Returns day, week or month buckets.
metrika_export_report
Starts a full CSV or JSON export job.

What it does

Verifiable reports
Answers include dates, time zone, sampling status, filters and provenance.
Period comparison
metrika_compare_periods gives absolute, percent and percentage-point changes under identical conditions.
Full exports
Background CSV or JSON exports cover every row with checksums and resume after restart.
Browser sign-in
Connect through the browser without an OAuth app of your own or pasted tokens.
Multiple accounts
Isolated connections keep separate counters for each account.
Strict accuracy
Sampled data is refused instead of being presented as exact.

Good for

  • Compare the last two complete weeks by traffic source
  • Find which landing pages produced the most goal conversions
  • Plot weekly visits since the start of the quarter
  • Export all October traffic sources to CSV
  • Investigate a drop in traffic

Pricing

Open source

MIT licensed

Yandex Metrika FAQ

Can it change my Metrika settings?

No. It is read-only, with no write endpoints and no raw HTTP tool.

Do I need an API key?

No. You sign in through the browser, though an existing OAuth token can be supplied for headless setups.

Can I try it without an account?

Yes, a synthetic demo connection is always available.

Where are tokens stored?

In the OS credential store such as macOS Keychain, Windows Credential Manager or Linux Secret Service.

What licence is it?

MIT.

Is Yandex Metrika free?

Yes. Yandex Metrika is open source, so you can use and self-host it for free.

How do I add Yandex Metrika to Claude Code?

Run this command in your terminal: claude mcp add yandex-metrika-mcp --env YANDEX_METRIKA_TOKEN='<YANDEX_METRIKA_TOKEN>' -- npx -y @dev-crabs/yandex-metrika-mcp

What are the best alternatives to Yandex Metrika?

The closest alternatives to Yandex Metrika are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Tapetide - Indian Stock Market MCP and World Monitor.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers