A
licenseNot graded
qualityD
maintenanceEnables querying and managing Greenhouse recruiting data through MCP, including applications, candidates, jobs, and rejection operations.
MIT
join-mcp
by michaeljauk
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@join-mcpList applications for job 123 and download the first candidate's CV"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
join-client
Community TypeScript SDK, CLI and MCP server for the JOIN recruiting API. Generated from the OpenAPI documents on docs.join.com. Not an official JOIN product.
Package | What it is |
Typed client on | |
| |
MCP server with two tools ( |
Quick start
Get a token at https://join.com/user/api-credentials. A token belongs to one JOIN company.
npm install -g join-com-cli
join-com auth login --profile acme # paste the token, or pipe it in
join-com jobs list
join-com applications list --job-id 123 --all | jq 'length'
join-com download "<attachments[].url from an application>" -o cv.pdfSDK:
import { collectPages, createJoinClient } from "join-sdk";
const join = createJoinClient({ token: process.env.JOIN_TOKEN! });
const { data: jobs } = await join.GET("/jobs", {
params: { query: { status: "ONLINE" } },
});
const applications = await collectPages((page) =>
join.GET("/applications", {
params: { query: { jobId: 123, page, pageSize: 50 } },
}),
);MCP (Claude Code):
claude mcp add join -e JOIN_PROFILE=acme -- npx -y join-mcpRelated MCP server: Instahyre MCP
Coverage
All 30 operations of JOIN API v2: jobs, applications, candidates, candidate notes, scorecards, tags, offices, categories, employment types, seniority levels and attachment downloads.
The JOIN API has no endpoint to move an application between pipeline stages, to reject it, or to send email. Use the JOIN web app for those.
Development
See AGENTS.md.
pnpm install
pnpm generate && pnpm typecheck && pnpm lint && pnpm build && pnpm test
pnpm spec:fetch # rebuild openapi.json from docs.join.comLicense
MIT for the code in this repository. The JOIN API and its documentation belong to JOIN.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues
Related MCP Connectors
Public MCP server for discovering open jobs. Search, filter, and get application links.
Remote MCP for 1,500+ APIs. Vault-managed credentials; OAuth or API key. Search, load, and execute.
A jobs data API and MCP server. Every listing comes from the employer's own career site, an ATS feed or a government employment service, never resold from another board. Each row names its source and when we last confirmed the vacancy existed, and a role that disappears keeps a closure date and a reason. Six tools: search_jobs, get_job, company_hiring, market_signals, coverage, changes_since.
Search people and companies, enrich profiles, and find email and phone over MCP.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceProvides MCP tools for job search, inbound recruiter activity triage, conversation inbox access, and guarded profile updates.-
- AlicenseAqualityBmaintenanceEnables searching and retrieving job listings from multiple platforms through MCP.2MIT
- AlicenseAqualityBmaintenanceEnables AI clients to manage JobZyn jobs and candidates through MCP tools for creating, updating, unpublishing jobs, retrieving candidate applications, and linking external IDs.538 npmMIT