Yandex Metrika MCP Dev Crabs
A read-only MCP server for Yandex Metrika: reports with exact dates, time zone and sampling status, browser sign-in.
- 130 ★ on the repository
- Last commit
Extended access
Why this level
- Reads Yandex Metrika reports of your account and passes them to the AI client and model provider.
- Keeps the Metrika access token in the system credential store.
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/yandex-metrika-mcp-dev-crabsDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads Yandex Metrika reports of your account and passes them to the AI client and model provider.
- Keeps the Metrika access token in the system credential store.
This is third-party code. Review the repository files before installing.
What it does
The server connects Claude, Cursor, VS Code, Codex and other MCP clients to Yandex Metrika and answers questions about traffic, sources, landing pages and goals. Every answer carries exact dates, the counter time zone, sampling status, filters and provenance, so the numbers can be checked. Calendar periods use the counter time zone, only complete days are counted by default, and in strict mode the server refuses sampled data. There are 13 tools and three prompts (`weekly_review`, `traffic_drop`, `landing_conversion`). They include a period report, a two-period comparison, time series and a background full export to CSV or JSON with checksums and resume after a restart. You sign in through the browser, with no OAuth app of your own and no token pasted into the chat.
Who it is for. Marketers and analysts who ask an assistant about site traffic and want to see how numbers were computed.
Good fit when
- You need to compare the last two complete weeks by visits and goal completions.
- You want to know which landing pages brought the most leads over a month.
- Traffic dropped and you need a `traffic_drop` review with verifiable numbers.
- You need a full October traffic source export to CSV for Excel.
Not a fit when
- You need to change counter settings or create goals: the server is read-only.
- You need a free-form Metrika API call: there is no raw HTTP tool.
- You need an older Node.js: 22.13 or newer is required.
Example request
Connect Yandex Metrika and compare the last two complete weeks by traffic source.MCP
- Transport
- stdio
- Authentication
- OAuth
Limitations
The server only reads data: it has no write methods and no raw HTTP tool. Node.js 22.13 or newer is required. The token is kept in the system credential store (macOS Keychain, Windows Credential Manager, Linux Secret Service), and without one the server refuses to save the token until you explicitly choose an unencrypted file readable only by your user. Reports you request go to your AI client and the model provider, tokens do not. Tests run on synthetic data and a simulated API, a live sign-in was checked on macOS, and other clients and platforms are tracked in `docs/release-checklist.md`.
How to disable. Call the `metrika_disconnect` tool, which removes the connection and token locally. Then remove the server from the client config, for Claude Code with `claude mcp remove yandex-metrika`.
FAQ
How do I connect Yandex Metrika to Claude Code?
Run `claude mcp add --scope user yandex-metrika -- npx -y @dev-crabs/yandex-metrika-mcp`, restart the client and ask the assistant to connect Metrika. It calls `metrika_connect` and gives a local sign-in link.
Do I need my own API key or OAuth app?
No, after install you sign in through the browser and the token never enters the chat. The synthetic `conn_demo` connection lets you try the server without an account.
How does the server handle sampling?
Strict accuracy mode refuses sampled data and never passes it off as exact. Totals come from the API response, and visible rows are never summed.
Can I export every row of a report?
Yes, `metrika_export_report` starts a background export to CSV or JSON with checksums and a manifest. Check status with `metrika_get_job`, and an interrupted export resumes after a restart.
How do I install the server in Cursor or VS Code?
Run `npx -y @dev-crabs/yandex-metrika-mcp setup --client cursor` or another client from the list: claude-desktop, claude-code, vscode, windsurf, codex. There are also one-click install buttons for Cursor and VS Code.
Discussion
No questions or reviews yet.
Related
All Yandex Metrica toolsYandex Metrica MCP
yandex-metrica-mcp
Read-only MCP server for Yandex Metrica: reports, period comparison, goals and raw log export with browser login
Yandex Metrika MCP
Yandex Metrika MCP Server
MCP server for Yandex Metrika reports: traffic, sources, search phrases, goals, geography, devices and content analytics
MCP Yandex Metrica with counter management
@theyahia/yandex-metrika-mcp
Yandex Metrica MCP server with 15 tools: reports and traffic plus creating, editing, and deleting counters and goals
Yandex Metrica MCP: reports and goals in Claude, Cursor and Codex
mcp-yandex-metrica
A Metrica MCP server run with npx and Yandex OAuth sign-in inside the chat: counters, goals, visit and conversion reports, read-only by default
Read-only Yandex Metrika MCP server
yandex-metrika-mcp
A minimalist Python MCP with 12 read-only tools using the correct OAuth header, paired with a skill that carries the period-comparison methodology
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Yandex Metrika MCP Dev Crabs (this card) | no | OAuth | 130 | |
| Yandex Metrica MCP | no | key is optional | 15 | another read-only Metrika MCP with raw data export; here browser sign-in, strict sampling mode and resumable export |
| Yandex Metrica MCP: reports and goals in Claude, Cursor and Codex | no | OAuth | 5 | an npx MCP with OAuth sign-in in chat; here the token never enters the chat and each answer carries dates and sampling status |
README in short
The README explains how the server stands out by data accuracy and safe sign-in, gives install commands for six clients, sample questions and a tool table. A data and privacy section says where tokens are stored, and Russian docs live in `README.ru.md` and `docs/ru`.