SkillFoxx

Type a name, a task or a service

HeadHunter MCP Server

An hh.ru API MCP server for job seekers: vacancy search, employer data, your resumes and applications with cover letters

MCP serverHigh riskRussian stack

gmen1057/headhunter-mcp-serverAuthor: gmen1057

Install

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env

Run inside a clone of gmen1057/headhunter-mcp-server.

This is third-party code. Review the repository files before installing.

What it does

The server connects the agent to the HeadHunter API. Without user auth the agent searches vacancies filtered by city, salary, experience and employment type, opens a vacancy and similar ones, and gets employer details, regions and dictionaries. After OAuth it reads the user's resumes and application history and applies to vacancies with a cover letter. The repository describes a separate agent workflow that matches vacancies against several resumes, scores them and saves a CSV report.

Who it is for. For job seekers and career coaches searching for jobs on hh.ru.

Good fit when

  • You need to shortlist vacancies by several criteria and compare them with your resume
  • You want a quick look at an employer and similar vacancies
  • You want to send an application with a letter tailored to the vacancy

Not a fit when

  • You need the employer side: resume search and vacancy management
  • You do not want the agent sending applications on your behalf without review

Example request

Find 10 Python developer vacancies in Moscow paying from 200,000 and show which fit my resume best

Limitations

You must register an app at dev.hh.ru and get a Client ID, Client Secret and app token. Applications and resumes work only after OAuth with a redirect URI. There is no package; install from a clone into a Python virtualenv. The vacancy matching workflow targets Moscow only.

How to disable. Remove the headhunter block from ~/.claude.json and revoke the app's access in your hh.ru account settings.

MCP

Transport
stdio
Authentication
OAuth
Environment variables
HH_CLIENT_ID
required		App Client ID from dev.hh.ru
HH_CLIENT_SECRET
required, secret		App Client Secret
HH_APP_TOKEN
required, secret		App token
HH_REDIRECT_URI
OAuth redirect URI

Security check

  • Sends job applications on the user's behalf
  • Reads resumes containing personal data
  • Holds app secrets and OAuth tokens

README in short

The English and Russian README lists ten tools and walks through setup: clone, virtualenv, registering an app at dev.hh.ru and a Claude Code config block. It separately covers the OAuth script for applications and the vacancy matching agent workflow. MIT licensed.

FAQ

Can I search without OAuth?

Yes, search, vacancies, employers and dictionaries work with app credentials. OAuth is needed for resumes, applications and application history.

Does it suit recruiters?

No, the tools target job seekers: there is no resume search or employer vacancy management.

Editors’ pick

A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more

CLIHigh risk31K
Editors’ pick

Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server

CLIMedium risk29.7K
Editors’ pick

A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI

MCP serverMedium risk28.1K
Editors’ pick

Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search

PluginHigh risk24K