HeadHunter MCP Server
An hh.ru API MCP server for job seekers: vacancy search, employer data, your resumes and applications with cover letters
- 32 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Sends job applications on the user's behalf
- Reads resumes containing personal data
- Holds app secrets and OAuth tokens
Install
- Works in
- Services
Manual install
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .envRun inside a clone of gmen1057/headhunter-mcp-server.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Sends job applications on the user's behalf
- Reads resumes containing personal data
- Holds app secrets and OAuth tokens
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 bestMCP
- Transport
- stdio
- Authentication
- OAuth
Environment variables
HH_CLIENT_IDrequired- App Client ID from dev.hh.ru
HH_CLIENT_SECRETrequired, secret- App Client Secret
HH_APP_TOKENrequired, secret- App token
HH_REDIRECT_URI- OAuth redirect URI
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. The public hh.ru specification has no applicant methods for reading your own resumes or creating applications, so these server tools may not work; test them before relying on them. 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.
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.
Discussion
No questions or reviews yet.
Related
All hh.ru toolsAn MCP server for the employer side of the hh.ru and hh.kz API: your vacancies, applications, resume search, sourcing and webhooks through an OAuth app
hh.ru MCP
hh-mcp
MCP server for the hh.ru API: vacancy and employer search, salary estimates, reference lists, resumes with employer access
A browser-based MCP server for job search on hh.ru: resume-matched vacancy recommendations, applications and statuses
A cookie-session MCP server that gives an agent hh.ru search, applications, chats and resume analytics hidden from job seekers, no official API
ats-mcp-server: jobs from hh.ru and ATS platforms
ats-mcp-server
An MCP server that aggregates vacancies from hh.ru and the public Greenhouse, Ashby, Lever, Workable and Bayt APIs into one format without HTML scraping
An MCP server with 52 tools over the official hh.ru API: vacancy search with no token, employer resumes and applications with one, and salary statistics
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.