hh-mcp

MCP server for the hh.ru API — Russia and CIS job market. 16 tools covering vacancies, resumes, employers, salary statistics, dictionaries, and autocomplete.

[](https://www.npmjs.com/package/@theyahia/hh-mcp) [](https://github.com/theYahia/hh-mcp/actions) [](https://opensource.org/licenses/MIT)

Part of the Russian API MCP series by @theYahia.

| Mode | What's available | Token needed? | |------|-----------------|:-------------:| | No token | Vacancy search, vacancy by ID, similar vacancies, employers, salary stats, areas, roles, dictionaries, suggests | No | | With token | Everything above + resume search, resume by ID | Yes (HH_ACCESS_TOKEN) |

Get a token at dev.hh.ru/admin.

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"],
      "env": {
        "HH_ACCESS_TOKEN": "optional-oauth-token"
      }
    }
  }
}

claude mcp add hh -- npx -y @theyahia/hh-mcp
# With token:
claude mcp add hh -e HH_ACCESS_TOKEN=your-token -- npx -y @theyahia/hh-mcp

{
  "servers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"]
    }
  }
}

{
  "mcpServers": {
    "hh": {
      "command": "npx",
      "args": ["-y", "@theyahia/hh-mcp"]
    }
  }
}

npx @theyahia/hh-mcp --http
# or
HTTP_PORT=8080 npx @theyahia/hh-mcp --http

Endpoint: http://localhost:3000/mcp Health check: http://localhost:3000/health

| Variable | Required | Description | |---