recruit-crm-mcp 0.3.0

MCP server for Recruit CRM

Recruit CRM MCP

MCP (Model Context Protocol) server for Recruit CRM, enabling AI assistants to search candidates, view jobs, and manage recruiting workflows.

Quick Start

One-Click Install (recommended)

Run the interactive installer — it configures Claude Desktop automatically:

uvx --from recruit-crm-mcp recruit-crm-mcp-install

The installer will:

• Check that uv is installed (and help you install it if not)
• Prompt for your Recruit CRM API key
• Back up your existing Claude Desktop config
• Add the Recruit CRM MCP server entry

Manual Setup

If you prefer to configure manually, add to your claude_desktop_config.json:

{
  "mcpServers": {
    "recruit-crm": {
      "command": "uvx",
      "args": ["recruit-crm-mcp"],
      "env": {
        "RECRUIT_CRM_API_KEY": "your-api-key-here"
      }
    }
  }
}

Development

uv sync              # install dependencies
make test            # run tests
make lint            # run linter
make check           # run lint + tests

Tools

Tool	Description
ping	Health check — verify the server is running and API key is configured
search_candidates	Search candidates by query, email, city, or job title
get_candidate	Get full profile details for a candidate by slug/ID
list_jobs	List job requisitions, optionally filtered by status
get_job	Get full details for a job by slug/ID

Resources

Resource	Description
recruitcrm://candidate/{id}/resume	Get resume URL for a candidate
recruitcrm://job/{id}/description	Get full job description

Configuration

Set the RECRUIT_CRM_API_KEY environment variable with your Recruit CRM API token.