
yandex-metrika-mcp
Read-only MCP server for Yandex Metrika (Яндекс Метрика): verifiable reports, period comparisons, time series and exports for Claude, Cursor, VS Code and Codex.
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up yandex-metrika-mcp (claude-plugin project) into my current project. Found on https://claudeers.com/yandex-metrika-mcp Repo: https://github.com/DevCrabs-Inc/yandex-metrika-mcp Homepage/docs: — Detected install method: claude-plugin → /plugin install yandex-metrika-mcp@DevCrabs-Inc/yandex-metrika-mcp Category: mcp-servers. Platforms: cli, api, desktop, web. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
⚠ Unverified / not recently updated — review before pasting a run-this config.
/plugin marketplace add DevCrabs-Inc/yandex-metrika-mcp /plugin install yandex-metrika-mcp@DevCrabs-Inc/yandex-metrika-mcp
git clone https://github.com/DevCrabs-Inc/yandex-metrika-mcp
// compatibility
| Platforms | cli, api, desktop, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | MIT |
| Pricing | open-source |
| Language | TypeScript |

Yandex Metrika MCP
Read-only MCP server for Yandex Metrika (Yandex Metrica, Яндекс Метрика). Connect it to Claude, Cursor, VS Code, Codex or any MCP client and ask about traffic, sources, landing pages and goals. Every answer comes with exact dates, the counter time zone, sampling status, filters and provenance, so the numbers can be checked.
Документация на русском: README.ru.md и docs/ru.
Status: 1.0.0, the first stable release; tool names, arguments and outputs follow semantic versioning. Covered by tests against synthetic data and a simulated API, and checked with a live Yandex sign-in and reports on macOS. Other clients and platforms are tracked in docs/release-checklist.md.
Website and guides
- Dev Crabs product overview (RU) — see the demo report and business questions the server can answer.
- SEO quickstart (RU) — connect your counter, compare organic landing pages and export a report.
- Client installation · Yandex sign-in · Report accuracy · Full exports (RU).
Why this server
- Sign in through the browser. No token pasting, no OAuth app of your own; the token never enters the chat.
- Numbers you can verify. Calendar periods in the counter time zone, complete days by default, strict accuracy that refuses sampled data instead of calling it exact, API totals instead of sums of visible rows.
- Several accounts and clients. Isolated connections with their own counters; nothing is shared between them.
- Full exports. Background CSV/JSON export of every row with checksums, a manifest and resume after a restart.
- Small, predictable surface. 13 tools, 3 prompts. Read-only: no write endpoints, no raw HTTP tool.
Install
Requires Node.js 22.13 or later. No API key and no OAuth app of your own: after installing, ask the assistant to connect Yandex Metrika and sign in through the browser.
One command (writes the client config and keeps a backup):
npx -y @dev-crabs/yandex-metrika-mcp setup --client claude-desktop # or claude-code, cursor, vscode, windsurf, codex
One click:
Claude Code:
claude mcp add --scope user yandex-metrika -- npx -y @dev-crabs/yandex-metrika-mcp
Any MCP client (mcpServers format; VS Code uses servers with "type": "stdio"):
{
"mcpServers": {
"yandex-metrika": { "command": "npx", "args": ["-y", "@dev-crabs/yandex-metrika-mcp"] }
}
}
On Windows some clients cannot start npx directly; use "command": "cmd", "args": ["/c", "npx", "-y", "@dev-crabs/yandex-metrika-mcp"], which is what setup writes there. Claude Desktop users can also install the .mcpb bundle from the GitHub release. AI agents installing the server should follow llms-install.md.
Restart the client and ask: "Connect Yandex Metrika and compare the last two weeks by traffic source." The assistant calls metrika_connect and gives you a local sign-in link. Try it without an account: the synthetic conn_demo connection is always available.
Example questions
- "Compare the last two complete weeks by visits and target visits of goal 3001."
- "Which landing pages brought the most leads for goal X last month?"
- "Show weekly visits since the start of the quarter."
- "Export all traffic sources for October to CSV for Excel."
Tools
| Tool | Purpose |
|---|---|
metrika_status | Connections, exports and the next step. Works before sign-in. |
metrika_connect / metrika_disconnect | Browser sign-in; local removal of a connection and its token. |
metrika_list_counters / metrika_describe_counter | Sites, time zones and goals with IDs. |
metrika_catalog | Presets, metrics (with aggregation rules), dimensions, period presets. |
metrika_run_report | One period: presets or explicit fields, filters, sorting, paging. |
metrika_compare_periods | Two periods under identical conditions: absolute, % and p.p. changes. |
metrika_run_timeseries | Day, week or month buckets with exact calendar boundaries. |
metrika_export_report / metrika_get_job / metrika_cancel_job / metrika_read_artifact | Full CSV/JSON exports as resumable background jobs. |
Prompts: weekly_review, traffic_drop, landing_conversion.
Data and privacy
Report data you request is sent to your AI client and its model provider; tokens never are. Tokens live in the OS credential store (macOS Keychain, Windows Credential Manager, Linux Secret Service). Without one, the server refuses to store tokens unless you explicitly choose an unencrypted user-only file. URL query strings are removed from labels by default. No telemetry. Details: docs/ru/privacy-security.md.
Development
pnpm install
pnpm check # Biome, tsc, vitest
pnpm build # dist/cli.js
pnpm mcpb # build/yandex-metrika-mcp-<version>.mcpb
See CONTRIBUTING.md and AGENTS.md. Security reports: SECURITY.md.
License
MIT © DevCrabs
// faq
What is yandex-metrika-mcp?
Read-only MCP server for Yandex Metrika (Яндекс Метрика): verifiable reports, period comparisons, time series and exports for Claude, Cursor, VS Code and Codex.. It is open-source on GitHub.
Is yandex-metrika-mcp free to use?
yandex-metrika-mcp is open-source under the MIT license, so it is free to use.
What category does yandex-metrika-mcp belong to?
yandex-metrika-mcp is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/yandex-metrika-mcp)
// retro hit counter
[](https://claudeers.com/yandex-metrika-mcp)
// reviews
// guestbook
// related in MCP Servers
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman
An open-source AI agent that brings the power of Gemini directly into your terminal.