join-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
join-client
A typed TypeScript SDK, CLI and MCP server for the JOIN recruiting API. Unofficial, community-maintained.

Why
JOIN publishes OpenAPI documents on docs.join.com, but no TypeScript client. This repo generates three packages from those documents:
join-sdk: a typed client onopenapi-fetch. It retries on HTTP 429 and has a helper for cursor paging (collectPages).join-com-cli: thejoin-comcommand, with one subcommand per endpoint. It prints JSON, so you can pipe the output throughjq.join-com skill installadds a Claude Code skill to~/.claude/skills/join/.join-mcp: a Model Context Protocol server for AI agents. It has two tools (search,execute) instead of one tool per endpoint.
Typical use cases:
Export the applications and CV documents of a job for a review outside JOIN
Move applications between pipeline stages from a script
Show your open jobs on your own careers page
Let an AI agent summarise new applications, candidate notes and scorecards
Related MCP server: Job Board MCP Server
Packages
Package | What it is |
Typed client on | |
| |
MCP server with two tools ( |
Quick start
Create a company API token in JOIN under Company Settings → Developer → API tokens. 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 "<documents[].url from an application>" -o cv.pdf
join-com skill install # optional: Claude Code skillSDK:
import { collectPages, createJoinClient } from "join-sdk";
const join = createJoinClient({ token: process.env.JOIN_TOKEN! });
const { data: page } = await join.GET("/jobs", {
params: { query: { status: ["ONLINE"] } },
});
const applications = await collectPages((cursor) =>
join.GET("/applications", {
params: { query: { jobId: 123, cursor, limit: 50 } },
}),
);MCP (Claude Code):
claude mcp add join -e JOIN_PROFILE=acme -- npx -y join-mcpCoverage
All 25 operations of JOIN API v3 (revision 2026-11-01): jobs, applications and stage moves,
candidates, candidate notes, scorecards, locations, contract types, employment types, pipeline
templates and remote regions. Application documents download from pre-signed URLs.
JOIN API v2 is not supported from 1.0 on. The JOIN API has no endpoint to reject an application,
update a candidate profile or send a message. Use the JOIN web app for those. A stage move
(move-stage) can trigger the stage's automated emails, as a move in JOIN does.
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.comDisclaimer
Unofficial and not affiliated with JOIN. "JOIN" is their trademark. The JOIN API and its documentation belong to JOIN.
Support
Built by Michael Jauk. If this saves you time, consider buying me a coffee.
License
MIT © Michael Jauk, for the code in this repository.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search recruiting CRM records, manage candidates, jobs, pipelines, notes and tasks with OAuth.
CRM1Public MCP server for discovering open jobs. Search, filter, and get application links.
Job search for Switzerland. Searches current listings on funkyjobs.ch by keyword, place with radius, workload, category and publishing date, and fetches a single listing with employer, location, workload and salary where stated. Read-only, no account needed. Docs: https://www.funkyjobs.ch/mcp-connector
Remote MCP for 1,500+ APIs. Vault-managed credentials; OAuth or API key. Search, load, and execute.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceProvides 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
- AlicenseAqualityCmaintenanceEnables AI clients to manage JobZyn jobs and candidates through MCP tools for creating, updating, unpublishing jobs, retrieving candidate applications, and linking external IDs.5104 npmMIT
- AlicenseAqualityCmaintenanceEnables MCP-compatible agents to search live job postings, score resumes against specific postings, and create or update tracked applications through their pipeline.4MIT