Integrations
Provides tools for interacting with Greenhouse's recruitment and applicant tracking system, enabling job listing with filtering, candidate management with pagination, application tracking, and moving applications between stages.
Greenhouse MCP Server
A Model Context Protocol (MCP) server implementation for the Greenhouse Harvest API. This server provides tools for interacting with Greenhouse's recruitment and applicant tracking system through MCP.
Features
- List jobs with filtering options
- List candidates with pagination
- List applications with filtering
- Move applications between stages
- More features coming soon!
Local Development Setup
- Install dependencies:
- Configure environment variables:
- Copy
.env.example
to.env
- Add your Greenhouse API key to
.env
:
- Build the project:
- Start the server:
Deployment
GitHub Deployment (Recommended)
- Fork or clone this repository to your GitHub account.
- Set up GitHub repository secrets:
- Go to your repository's Settings > Secrets and variables > Actions
- Add a new secret named
GREENHOUSE_API_KEY
with your API key
- Enable GitHub Actions:
- Go to your repository's Actions tab
- Enable workflows if they're not already enabled
- Push your code to the main branch:
- The GitHub Actions workflow will automatically:
- Build and test your code
- Create a Docker image
- Push the image to GitHub Container Registry (ghcr.io)
- To use the deployed container:
Using Docker Locally
- Make sure you have Docker and Docker Compose installed on your system.
- Configure your environment:
- Ensure your
.env
file contains the correctGREENHOUSE_API_KEY
- The
.env
file will be used by Docker Compose for environment variables
- Ensure your
- Build and start the container:
- Check the logs:
- Stop the server:
Manual Deployment
For manual deployment on a server:
- Install Node.js (v20 or later) on your server
- Clone the repository:
- Install dependencies:
- Set up environment variables:
- Build the project:
- Start with PM2 (recommended for production):
Available Tools
list_jobs
Lists all jobs in Greenhouse with optional status filtering.
Parameters:
status
(optional): Filter jobs by status ('open', 'closed', 'draft')
list_candidates
Lists candidates in Greenhouse with pagination support.
Parameters:
per_page
(optional): Number of candidates per pagepage
(optional): Page number
list_applications
Lists applications in Greenhouse with filtering options.
Parameters:
job_id
(optional): Filter by job IDstatus
(optional): Filter by application status
move_application
Moves an application to a different stage.
Parameters:
application_id
(required): ID of the application to movestage_id
(required): ID of the target stage
Health Check
The server provides a health check endpoint at /tools
that returns the list of available tools.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A server implementation that enables interaction with Greenhouse's recruitment and applicant tracking system through Model Context Protocol, providing tools for job listings, candidate management, application filtering, and stage transitions.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables seamless interaction with LinkedIn for job applications, profile retrieval, feed browsing, and resume analysis through natural language commands.Last updated -10Python
- -security-license-qualityA Model Context Protocol server that enables interaction with Salesforce through REST API using jsforce, allowing users to execute SOQL queries, retrieve object metadata, and perform CRUD operations on Salesforce records.Last updated -
- -securityAlicense-qualityA Model Context Protocol server that enables Claude Desktop to access structured employee data and perform HR operations including employee lookups, searches, and global leave requests.Last updated -JavaScriptMIT License
- -security-license-qualityA Model Context Protocol server that enables querying attendance information and managing employee leave requests, overtime requests, and schedules.Last updated -Python