open-greenhouse-mcp

リクルーターおよび採用チーム向けに設計された、Greenhouse用のプロダクションレディなMCPサーバーです。

ほとんどのGreenhouse MCPサーバーはAPIエンドポイントをそのままミラーリングしていますが、本サーバーは採用チームのために構築されています。安全なデフォルト設定、ロールベースのプロファイル、そして多段階のAPI操作を単一のアクションに変換するワークフローツールを提供します。

プロファイルの選択

Related MCP server: Greenhouse MCP Server by CData

クイックスタート

pip install open-greenhouse-mcp

MCPクライアントの設定に追加してください（Claude Desktopの場合: ~/Library/Application Support/Claude/claude_desktop_config.json、Cursorの場合: 設定 > MCP）:

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

まずは接続とツールの動作を確認するために読み取り専用モードで開始し、書き込みアクセスが必要になったら recruiter または full に切り替えてください。

APIキーはGreenhouseの「Configure > Dev Center > API Credential Management」から取得できます。

できること

• 「シニアエンジニア職のパイプラインを表示して」

• 「今週対応が必要な候補者は誰？」

• 「バックエンドインターン職のコンバージョン率は？」

• 「Sarah Chenを探して履歴書を表示して」

• 「どのソースが実際に採用につながっている？」

• 「アカウントマネージャー職で30日以上非アクティブな応募をすべて一括不採用にして」

• 「バックエンドエンジニア職のこの候補者をスクリーニングして。全体像を教えて」

• 「Rustと分散システムの経験がある候補者をエンジニアリングのパイプラインから検索して」

• 「昨日から新しく届いた応募は何？」

詳細な出力例も参照してください。

動作イメージ

安全性

• アクセスはGreenhouse APIキーの権限によって制限されます

• 初回セットアップには読み取り専用プロファイルを推奨します

• 破壊的な操作には明示的なIDが必要です。サーバーがターゲットを推測することはありません

• 書き込み操作は GREENHOUSE_ON_BEHALF_OF を介した監査属性をサポートしています

• 一括操作はAPI制限内に収まるようレート制限されています

互換性

起動

サーバー起動時に設定がログ出力されます:

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

含まれる機能

• スクリーニングおよびソーシングツール — 候補者のスクリーニング、ブール演算キーワードによる履歴書検索、日次ダイジェスト、場所の検出など6つのツール

• リクルーターワークフローツール — パイプライン表示、分析、検索、一括操作のための13の複合ツール

• Harvest API対応 — 候補者、応募、求人、オファー、面接などに関する148のツール

• Job Board API — 公開求人リストおよび応募送信のための13のツール

• オプションのWebhookおよびインジェスト — イベント駆動型ワークフローおよびパートナー連携のための14のツール

リファレンス

スクリーニングおよびソーシングツール

候補者の評価およびプロアクティブな人材検索のためのツールです。

複合ツール

複数のAPI呼び出しを単一の操作にまとめた高度なツールです。

プロファイルの詳細

Recruiterには、すべての読み取りツール、すべてのスクリーニング/ソーシングツール、すべての複合ワークフロー、およびリクルーターにとって安全な書き込み操作（不採用、進める、採用、移動、タグ付け、メモ、添付ファイル、面接、見込み客、一括操作）が含まれます。求人作成、ユーザー管理、カスタムフィールド設定、候補者削除、Webhook管理は除外されます。

Read-onlyはすべての書き込み操作をスキップします。GREENHOUSE_READ_ONLY=true も省略形として機能します。

設定

ロギング

可観測性のための構造化JSONロギング。有効にするには GREENHOUSE_LOG_LEVEL=info を設定してください:

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

その他のドキュメント

• APIリファレンス — カテゴリ別の全ツール詳細

• 使用例 — 完全な出力を含む実際の会話例

• 高度なセットアップ — Webhookレシーバー、インジェストAPI、ボードトークンモード

• 開発 — 貢献、テスト、プロジェクト構造

フィードバック

• バグや機能要望: Issueを作成

• 質問: ディスカッションを開始

• セキュリティ: SECURITY.md を参照

• 貢献: CONTRIBUTING.md を参照

ライセンス

MIT License -- Ben Monopoli. LICENSE を参照。