Yandex Metrica MCP — Claude Code MCP server: install
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.
MIT ★ 7 updated 2026-11-13
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-metricaWhat Yandex Metrica MCP 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.
What it helps with
- 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 for the agent
- 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?
How to install Yandex Metrica MCP
Platform CLI
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-metricaReplace <…> with your own values. 2 more environment variables are in the server README
Platform CLI
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-metricaReplace <…> with your own values. 2 more environment variables are in the server README
Config file
{
"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
Config file
{
"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
Platform CLI
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-metricaReplace <…> with your own values. 2 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Yandex Metrica MCP
How do I install Yandex Metrica MCP in Claude Code?
Run claude mcp add mcp-yandex-metrica -e YANDEX_METRIKA_TOKEN=<YANDEX_METRIKA_TOKEN> -- npx -y mcp-yandex-metrica. Node.js 20 or later is required.
What does Yandex Metrica MCP do?
It connects an assistant to Yandex Metrica counters and retrieves website traffic, goal, and analytics data for a selected period.
What data can Yandex Metrica MCP retrieve?
It can report visits, users, page views, bounce rate, visit duration, traffic sources, and goal completions. Its dedicated reporting tools do not modify Metrica data.