open-greenhouse-mcp

PyPI Python 3.10+ License: MIT open-greenhouse-mcp MCP server

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

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

プロファイルの選択

プロファイル	ツール数	書き込み可否	推奨対象
`read-only`	97	いいえ	初回セットアップ、レポート作成、採用マネージャー
`recruiter`	121	はい (安全な操作)	日常的な採用業務
`full`	175	はい (すべて)	管理者、運用担当者、高度な自動化

クイックスタート

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日以上非アクティブな応募をすべて一括不採用にして」

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

動作イメージ

Demo

安全性

アクセス権限はGreenhouse APIキーの権限によって制限されます
初回セットアップには読み取り専用プロファイルを推奨します
破壊的な操作には明示的なIDが必要です。サーバーがターゲットを推測することはありません
書き込み操作は GREENHOUSE_ON_BEHALF_OF を介した監査属性をサポートしています
一括操作はAPI制限内に収まるようレート制限されています

互換性

クライアント	ステータス
Claude Desktop	対応
Claude Code	対応
Cursor	対応
トランスポート	stdio
Python	3.10+

起動

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

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

含まれる機能

リクルーター向けワークフローツール — パイプラインビュー、分析、検索、一括操作のための13個の複合ツール
Harvest API対応 — 候補者、応募、求人、オファー、面接などに関する148個のツール
Job Board API — 公開求人リストおよび応募送信のための13個のツール
オプションのWebhookとインジェスト — イベント駆動型ワークフローおよびパートナー連携のための14個のツール

リファレンス

複合ツール

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

ツール	機能
`pipeline_summary`	パイプラインの全体表示 — ステージごとにグループ化された候補者名とステージ滞在日数
`candidates_needing_action`	停滞している応募やスコアカードが不足している面接を検索
`stale_applications`	N日間アクティビティがない応募を、停滞期間が長い順に表示
`pipeline_metrics`	ステージごとのコンバージョン率、採用/不採用率、ステージ滞在時間
`source_effectiveness`	どの候補者ソースが最も高い採用率を生み出しているか
`time_to_hire`	応募から採用までの平均、中央値、最小、最大日数
`bulk_reject`	レート制限を考慮しつつ、一度の呼び出しで複数の応募を不採用にする
`bulk_tag`	一度の呼び出しで複数の候補者にタグ付けする
`bulk_advance`	複数の応募を次のステージに進める
`search_candidates_by_name`	名または姓で候補者を検索
`search_candidates_by_email`	正確なメールアドレスで候補者を検索
`read_candidate_resume`	候補者の最新の履歴書をダウンロードして返す
`download_attachment`	URLを指定してGreenhouseの添付ファイルをダウンロード

プロファイル詳細

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

Read-only プロファイルはすべての書き込み操作をスキップします。GREENHOUSE_READ_ONLY=true を指定することでも同様の動作になります。

設定

変数	必須	説明
`GREENHOUSE_API_KEY`	はい*	Harvest APIキー
`GREENHOUSE_BOARD_TOKEN`	はい*	求人ボードのURLスラッグ。*少なくともどちらか一つが必要
`GREENHOUSE_TOOL_PROFILE`	いいえ	`full` (デフォルト), `recruiter`, または `read-only`
`GREENHOUSE_ON_BEHALF_OF`	いいえ	書き込み監査証跡用のGreenhouseユーザーID
`GREENHOUSE_LOG_LEVEL`	いいえ	`debug`, `info`, `warning` (デフォルト), `error`
`GREENHOUSE_LOG_FILE`	いいえ	ログファイルのパス (デフォルトはstderr)

ログ出力

可観測性のために構造化された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 を参照。

Greenhouse MCP