Research & Data · Search Tools

Headhunter MCP Server logo

Headhunter MCP Server

gmen1057/headhunter-mcp-server

MCP (Model Context Protocol) server for integrating HeadHunter API with Claude Code and other MCP clients. HeadHunter (hh.ru) is the largest job search platform in Russia and CIS countries. This MCP server provides seamless integration with HeadHunter API, enabling AI assistants to search vacancies, manage resumes, and apply to jobs on your behalf.

Install

Client configuration

{
  "mcpServers": {
    "headhunter": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "/path/to/headhunter-mcp-server/server.py"
      ],
      "env": {
        "HH_CLIENT_ID": "<HH_CLIENT_ID>",
        "HH_CLIENT_SECRET": "<HH_CLIENT_SECRET>",
        "HH_APP_TOKEN": "<HH_APP_TOKEN>",
        "HH_REDIRECT_URI": "<HH_REDIRECT_URI>"
      }
    }
  }
}

Environment variables

HH_CLIENT_IDHH_CLIENT_SECRETHH_APP_TOKENHH_REDIRECT_URI
Author
@gmen1057
Category
Research & Data, Search Tools
License
MIT
Updated
Oct 6, 2026

About Headhunter MCP Server

MCP (Model Context Protocol) server for integrating HeadHunter API with Claude Code and other MCP clients.

HeadHunter (hh.ru) is the largest job search platform in Russia and CIS countries. This MCP server provides seamless integration with HeadHunter API, enabling AI assistants to search vacancies, manage resumes, and apply to jobs on your behalf.

Features

  • Advanced Vacancy Search - Filter by location, salary, experience, employment type

  • Resume Management - View and manage your HeadHunter resumes

  • Job Applications - Apply to vacancies with custom cover letters

  • Company Information - Get detailed employer data

  • Application Tracking - Monitor your job application history

  • AI-Powered Agent - Automated vacancy hunter with intelligent matching

  • OAuth 2.0 - Secure authorization with HeadHunter

Tools (10)

  • hh_search_vacancies

    Search for job vacancies

  • hh_get_vacancy

    Get detailed vacancy information

  • hh_get_employer

    Get company/employer details

  • hh_get_similar

    Find similar vacancies

  • hh_get_areas

    Get list of regions/cities

  • hh_get_dictionaries

    Get reference data (experience, employment types, etc.)

  • hh_get_resumes

    Get your resumes list

  • hh_get_resume

    Get detailed resume information

  • hh_apply_to_vacancy

    Apply to a vacancy (requires OAuth)

  • hh_get_negotiations

    Get application history (requires OAuth)

Details on this page are taken from the project's README. Open README

Related MCP servers

More servers
Firecrawl MCP Server logo

Firecrawl MCP Server

mendableai/firecrawl-mcp-server

2.8k

A Model Context Protocol (MCP) server that brings Firecrawl to MCP-compatible AI agents — search, scrape, and interact with the live web for clean, agent-ready context.

Research & Data
Exa Web Search logo

Exa Web Search

exa-labs/exa-mcp-server

1.4k

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Research & Data
ArXiv logo

ArXiv

blazickjp/arxiv-mcp-server

1k

A local MCP server for agent literature work. The differentiator is original-LaTeX section reads, BibTeX from arXiv metadata, and topic watches. Papers stay on disk.

Research & Data
sail logo

sail

lakehq/sail

730

Sail is a drop-in Apache Spark replacement written in Rust, unifying batch processing, stream processing, and compute-intensive AI workloads on a distributed, multimodal compute engine.

Research & Data

OpenAPI Proxy

janwilmake/openapi-mcp-server

554

A Model Context Protocol (MCP) server for Claude/Cursor that enables searching and exploring OpenAPI specifications through oapis.org.

Research & Data
Excel MCP Server logo

Excel MCP Server

haris-musa/excel-mcp-server

393

A Model Context Protocol server that lets AI assistants create, read and edit Excel workbooks. It needs no Microsoft Excel installation.

Research & Data