Hh MCP

MCP server for the hh.ru API - Russia and CIS job market. 19 tools covering vacancies, resumes, employers, salary statistics, dictionaries, autocomplete, and token diagnostics. It runs locally over stdio via the published package.

People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-23 · ★ 4 · #122 OF 250 MAINTAINED API INTEGRATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Hh MCP

before you install - you'll need

HH_ACCESS_TOKEN, HTTP_PORT are optional or environment-specific per the README.

Claude Code

claude mcp add theyahia-hh-mcp -- npx -y @theyahia/hh-mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @theyahia/hh-mcp - published under the repo owner's npm scope (@theyahia)

registry namespace io.github.theYahia is GitHub-verified and matches the repo owner

03 · What Hh MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can find vacancies similar to a given one, search candidate resumes by keywords, region, role, salary, experience, search companies by name and region, and list active vacancies for a specific employer.

Capability map

Tools grouped from the project's README - what Hh MCP lets an agent do.

read & search

11 tools - e.g. Search by keywords, region, professional role, industry, metro, employer, salary, experience, work format / employment form, date range (period or date_from/dat; Full vacancy details: description…

search_vacancies · get_vacancy · get_similar_vacancies · search_resumes · get_resume · search_employers…

Areas

3 tools - e.g. Tree of regions and cities (id - name); Regions/cities under one area id - lighter than the full tree; Autocomplete region/city names

get_areas · get_areas_subtree · suggest_areas

Employer

2 tools - e.g. Employer profile: description, industries, website, vacancy count; List active vacancies for a specific employer

get_employer · get_employer_vacancies

Suggest

2 tools - e.g. Autocomplete job titles; Autocomplete company names

suggest_positions · suggest_companies

auth & access

1 tool - e.g. Check whether HH_ACCESS_TOKEN is valid (via /me) and report the account role

validate_token

04 · Who maintains Hh MCP

hh-mcp is maintained by theyahia. We track 49 MCP servers from theyahia - 43 actively maintained, 72 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from theyahia.

05 · Facts

repository: github.com/theyahia/hh-mcp
category: API integration - ranked #122 of 250 actively-maintained API integration servers as of 2026-08-25.
registry: io.github.theYahia/hh-mcp (active, first published 2026-03-31)
packages: npm:@theyahia/hh-mcp

06 · Hh MCP FAQ

Is Hh MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-23. We re-verify nightly.

What can Hh MCP do?

How do I install Hh MCP?

Run `npx -y @theyahia/hh-mcp`. The README documents 2 environment variables (HH_ACCESS_TOKEN, HTTP_PORT) to set first. HH_ACCESS_TOKEN, HTTP_PORT are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Hh MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Hh MCP

Alternatives to Hh MCP

Maintained API integration servers if Hh MCP isn't the fit.

More API integration MCP servers · Megaplan MCP · Mindbox MCP · Planfix MCP · Voximplant MCP · Yandex Webmaster MCP (theyahia)

More TypeScript MCP servers · Moysklad MCP · Tilda MCP · see all