open-greenhouse-mcp

Production-ready MCP server for Greenhouse, designed for recruiters and hiring teams.

Most Greenhouse MCP servers mirror the API endpoint by endpoint. This one is built for recruiting teams: safe defaults, role-based profiles, and workflow tools that turn multi-step API operations into single actions.

Choose a Profile

Quick Start

pip install open-greenhouse-mcp

Add to your MCP client config (Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json, Cursor: Settings > MCP):

{
  "mcpServers": {
    "greenhouse": {
      "command": "open-greenhouse-mcp",
      "env": {
        "GREENHOUSE_API_KEY": "your-harvest-api-key",
        "GREENHOUSE_TOOL_PROFILE": "read-only"
      }
    }
  }
}

Start in read-only mode to validate connectivity and tool behaviour, then switch to recruiter or full when you need write access.

Your API key is in Greenhouse under Configure > Dev Center > API Credential Management.

What You Can Ask

• "Show me the pipeline for our Senior Engineer role"

• "Who needs my attention this week?"

• "What are our conversion rates for the Backend Intern role?"

• "Find Sarah Chen and pull up her resume"

• "Which sources are actually producing hires?"

• "Bulk reject everything inactive for 30+ days on the Account Manager role"

See more examples with full output.

See it in action

Safety

• Access is limited by your Greenhouse API key permissions

• Read-only profile is recommended for first setup

• Destructive actions require explicit IDs — the server never infers targets

• Write operations support audit attribution via GREENHOUSE_ON_BEHALF_OF

• Bulk actions are rate-limited to stay within API limits

Compatibility

Startup

When the server starts, it logs its configuration:

open-greenhouse-mcp v0.3.0
Profile: recruiter | Tools: 121 | Writes: recruiter-safe | APIs: harvest, ingestion

What's Included

• Recruiter workflow tools — 13 composite tools for pipeline views, analytics, search, and bulk operations

• Harvest API coverage — 148 tools across candidates, applications, jobs, offers, interviews, and more

• Job Board API — 13 tools for public job listings and application submission

• Optional webhooks and ingestion — 14 tools for event-driven workflows and partner integrations

Reference

Composite Tools

High-level tools that combine multiple API calls into single operations.

Profile Details

Recruiter includes all read tools, all composite workflows, and recruiter-safe writes: reject, advance, hire, move, tag, notes, attachments, interviews, prospects, and bulk operations. It excludes job creation, user management, custom field configuration, candidate deletion, and webhook management.

Read-only skips all write operations. GREENHOUSE_READ_ONLY=true also works as a shorthand.

Configuration

Logging

Structured JSON logging for observability. Set GREENHOUSE_LOG_LEVEL=info to enable:

{"ts": "2026-04-14T12:31:58", "level": "info", "event": "api_call", "method": "GET", "url": "...", "status": 200, "latency_ms": 245.0}

More Documentation

• API Reference — Full tool breakdown by category

• Usage Examples — Real conversations with full output

• Advanced Setup — Webhook receiver, ingestion API, board-token mode

• Development — Contributing, testing, project structure

Feedback

• Bugs and features: Open an issue

• Questions: Start a discussion

• Security: See SECURITY.md

• Contributing: See CONTRIBUTING.md

License

MIT License -- Ben Monopoli. See LICENSE.