open-greenhouse-mcp

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

Servidor MCP listo para producción para Greenhouse, diseñado para reclutadores y equipos de contratación.

La mayoría de los servidores MCP de Greenhouse reflejan la API punto por punto. Este está diseñado para equipos de reclutamiento: valores predeterminados seguros, perfiles basados en roles y herramientas de flujo de trabajo que convierten operaciones de API de varios pasos en acciones únicas.

Elija un perfil

Perfil	Herramientas	¿Puede escribir?	Recomendado para
`read-only`	97	No	Configuración inicial, informes, gerentes de contratación
`recruiter`	121	Sí (ops seguras)	Trabajo de reclutamiento diario
`full`	175	Sí (todas)	Administradores, operaciones, automatización avanzada

Inicio rápido

pip install open-greenhouse-mcp

Añada a la configuración de su cliente MCP (Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json, Cursor: Ajustes > MCP):

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

Inicie en modo de solo lectura para validar la conectividad y el comportamiento de las herramientas, luego cambie a recruiter o full cuando necesite acceso de escritura.

Su clave API se encuentra en Greenhouse en Configurar > Centro de desarrolladores > Gestión de credenciales API.

Qué puede preguntar

"Muéstrame el proceso para nuestro puesto de Ingeniero Senior"
"¿Quién necesita mi atención esta semana?"
"¿Cuáles son nuestras tasas de conversión para el puesto de Pasante de Backend?"
"Busca a Sarah Chen y obtén su currículum"
"¿Qué fuentes están produciendo realmente contrataciones?"
"Rechazar masivamente todo lo inactivo durante más de 30 días en el puesto de Gerente de Cuenta"

Consulte más ejemplos con resultados completos.

Véalo en acción

Demo

Seguridad

El acceso está limitado por los permisos de su clave API de Greenhouse
Se recomienda el perfil de solo lectura para la primera configuración
Las acciones destructivas requieren IDs explícitos: el servidor nunca infiere objetivos
Las operaciones de escritura admiten la atribución de auditoría a través de GREENHOUSE_ON_BEHALF_OF
Las acciones masivas tienen límites de velocidad para mantenerse dentro de los límites de la API

Compatibilidad

Cliente	Estado
Claude Desktop	Compatible
Claude Code	Compatible
Cursor	Compatible
Transporte	stdio
Python	3.10+

Inicio

Cuando el servidor se inicia, registra su configuración:

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

Qué incluye

Herramientas de flujo de trabajo para reclutadores — 13 herramientas compuestas para vistas de procesos, análisis, búsqueda y operaciones masivas
Cobertura de la API Harvest — 148 herramientas para candidatos, solicitudes, empleos, ofertas, entrevistas y más
API de bolsa de trabajo — 13 herramientas para listados de empleos públicos y envío de solicitudes
Webhooks e ingesta opcionales — 14 herramientas para flujos de trabajo basados en eventos e integraciones de socios

Referencia

Herramientas compuestas

Herramientas de alto nivel que combinan múltiples llamadas a la API en operaciones únicas.

Herramienta	Qué hace
`pipeline_summary`	Vista completa del proceso: candidatos agrupados por etapa con nombres y días en la etapa
`candidates_needing_action`	Encuentra solicitudes estancadas y entrevistas a las que les faltan tarjetas de puntuación
`stale_applications`	Solicitudes sin actividad durante N días, ordenadas por las más antiguas
`pipeline_metrics`	Tasas de conversión, tasas de contratación/rechazo, tiempo en etapa por etapa
`source_effectiveness`	Qué fuentes de candidatos producen las mejores tasas de contratación
`time_to_hire`	Días promedio, medianos, mínimos y máximos desde la solicitud hasta la contratación
`bulk_reject`	Rechazar múltiples solicitudes en una llamada con manejo de límites de velocidad
`bulk_tag`	Etiquetar múltiples candidatos en una llamada
`bulk_advance`	Avanzar múltiples solicitudes a la siguiente etapa
`search_candidates_by_name`	Encontrar candidatos por nombre o apellido
`search_candidates_by_email`	Buscar un candidato por correo electrónico exacto
`read_candidate_resume`	Descargar y devolver el currículum más reciente de un candidato
`download_attachment`	Descargar cualquier archivo adjunto de Greenhouse por URL

Detalles del perfil

Recruiter incluye todas las herramientas de lectura, todos los flujos de trabajo compuestos y escrituras seguras para reclutadores: rechazar, avanzar, contratar, mover, etiquetar, notas, archivos adjuntos, entrevistas, prospectos y operaciones masivas. Excluye la creación de empleos, la gestión de usuarios, la configuración de campos personalizados, la eliminación de candidatos y la gestión de webhooks.

Read-only omite todas las operaciones de escritura. GREENHOUSE_READ_ONLY=true también funciona como abreviatura.

Configuración

Variable	Requerido	Descripción
`GREENHOUSE_API_KEY`	Sí*	Clave API de Harvest
`GREENHOUSE_BOARD_TOKEN`	Sí*	Slug de URL de la bolsa de trabajo. *Se requiere al menos uno
`GREENHOUSE_TOOL_PROFILE`	No	`full` (predeterminado), `recruiter` o `read-only`
`GREENHOUSE_ON_BEHALF_OF`	No	ID de usuario de Greenhouse para pista de auditoría de escritura
`GREENHOUSE_LOG_LEVEL`	No	`debug`, `info`, `warning` (predeterminado), `error`
`GREENHOUSE_LOG_FILE`	No	Ruta del archivo de registro (predeterminado a stderr)

Registro

Registro JSON estructurado para observabilidad. Establezca GREENHOUSE_LOG_LEVEL=info para habilitar:

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

Más documentación

Referencia de API — Desglose completo de herramientas por categoría
Ejemplos de uso — Conversaciones reales con resultados completos
Configuración avanzada — Receptor de webhook, API de ingesta, modo de token de tablero
Desarrollo — Contribución, pruebas, estructura del proyecto

Comentarios

Errores y características: Abrir un issue
Preguntas: Iniciar una discusión
Seguridad: Ver SECURITY.md
Contribución: Ver CONTRIBUTING.md

Licencia

Licencia MIT -- Ben Monopoli. Ver LICENSE.

Greenhouse MCP