open-greenhouse-mcp

Connect your AI assistant to Greenhouse. MCP (Model Context Protocol) lets AI tools like Claude, Cursor, and others talk directly to your software. This server gives them full access to Greenhouse — 175 tools covering recruiting pipelines, candidate search, analytics, batch operations, and the complete Greenhouse API.

Works with

• Claude Desktop and Claude Code
• Cursor
• Any MCP-compatible client

What Can It Do?

Ask your AI assistant questions like these — it handles the Greenhouse API calls automatically:

Plus 148 tools covering every Greenhouse Harvest API endpoint, 13 Job Board tools, 6 Ingestion API tools, and 8 webhook management tools.

See it in action

Three queries — pipeline view, source analysis, time-to-hire metrics — each resolved in a single tool call. See more examples.

Quick Start

pip install open-greenhouse-mcp

Or install from source:

git clone https://github.com/benmonopoli/open-greenhouse-mcp.git
cd open-greenhouse-mcp
pip install -e .

Set your API key:

export GREENHOUSE_API_KEY=your-harvest-api-key

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"
      }
    }
  }
}

Restart your client and start asking questions.

Composite Tools (13 tools)

High-level tools that match how recruiters actually work. These combine multiple API calls into single operations.

Harvest API (148 tools)

Full coverage of every Greenhouse Harvest API endpoint.

Other APIs

Job Board API (13 tools)

List boards, jobs, posts, departments, offices, and questions from public job boards.

Ingestion API (6 tools)

Submit applications and prospects programmatically. Requires GREENHOUSE_ON_BEHALF_OF.

Webhook Management (8 tools)

Create, list, update, and delete webhook subscriptions. Query received events with filtering.

Authentication

Set at least one. Both can be configured simultaneously.

You can find your API key in Greenhouse under Configure > Dev Center > API Credential Management.

Webhook Receiver

The built-in webhook receiver stores Greenhouse events in SQLite for querying via MCP tools.

# Set your webhook secret (from Greenhouse settings)
export GREENHOUSE_WEBHOOK_SECRET=your-secret

# Start the receiver
open-greenhouse-mcp-receiver

Configure the webhook URL in Greenhouse to point to http://your-host:8080/webhooks/greenhouse.

Development

git clone https://github.com/benmonopoli/open-greenhouse-mcp.git
cd open-greenhouse-mcp
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Lint
ruff check src/ tests/

# Type check
mypy src/greenhouse_mcp/ --ignore-missing-imports

Feedback and Issues

• Bug reports and feature requests: Open an issue
• Questions and discussion: Start a discussion
• Security vulnerabilities: See SECURITY.md

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT License -- Ben Monopoli. See LICENSE.

This project follows the Contributor Covenant Code of Conduct.