ashby-mcp
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., "@ashby-mcp Search for candidate Jonathan Howard"
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.
Ashby MCP Server
An MCP (Model Context Protocol) server for integrating with Ashby ATS. Use this with Claude Code or other MCP-compatible clients to search candidates, view applications, and submit interview feedback.
Features
Search candidates by name or email
Get candidate details including contact info and resume
List applications for a candidate
Submit interview feedback with ratings and notes
View feedback from other interviewers
List open jobs
View interview schedules
Related MCP server: MCP Ashby Connector
Installation
npm install -g ashby-mcpOr clone and build locally:
git clone https://github.com/antonber/ashby-mcp.git
cd ashby-mcp
npm install
npm run buildConfiguration
1. Get your Ashby API Key
Log into Ashby
Go to Settings → API Keys
Create a new API key with appropriate permissions
2. Configure Claude Code
Add to your Claude Code MCP settings (~/.claude/claude_desktop_config.json or project .mcp.json):
{
"mcpServers": {
"ashby": {
"command": "npx",
"args": ["ashby-mcp"],
"env": {
"ASHBY_API_KEY": "your-api-key-here"
}
}
}
}Or if installed locally:
{
"mcpServers": {
"ashby": {
"command": "node",
"args": ["/path/to/ashby-mcp/dist/index.js"],
"env": {
"ASHBY_API_KEY": "your-api-key-here"
}
}
}
}Available Tools
Tool | Description |
| Search for candidates by name or email |
| Get detailed candidate information |
| List all applications for a candidate |
| Get details about a specific application |
| Submit interview feedback with rating and notes |
| Get all feedback for an application |
| List jobs (filterable by status) |
| Get interview schedule for an application |
Usage Examples
Once configured, you can use natural language with Claude:
"Search for Jonathan Howard in Ashby"
"Get the applications for candidate abc123"
"Submit my interview feedback for Jonathan - Yes rating with these notes: ..."
"Pull the feedback other interviewers have submitted for this candidate"
Feedback Ratings
When submitting feedback, use one of these ratings:
strong_yes- Exceptional candidateyes- Good candidate, proceedlean_yes- Some positives, worth discussinglean_no- Some concerns, discuss with teamno- Does not meet barstrong_no- Clear no
Development
# Install dependencies
npm install
# Build
npm run build
# Watch mode
npm run devLicense
MIT
Available Tools
9 toolsadd_candidate_noteB
Add a note to a candidate in Ashby
Inputs: note (required), candidateId (required), title.
get_applicationC
Get details about a specific job application
Inputs: applicationId (required).
get_application_feedbackA
Get all feedback submitted for an application
Inputs: applicationId (required).
get_candidateB
Get detailed information about a candidate including their applications
Inputs: candidateId (required).
get_interview_scheduleC
Get interview schedule for an application
Inputs: applicationId (required).
list_candidate_applicationsA
List all applications for a candidate
Inputs: candidateId (required).
list_jobsB
List all open jobs
Inputs: status.
search_candidatesB
Search for candidates in Ashby by name or email
Inputs: query (required), limit.
submit_feedbackB
Submit interview feedback/scorecard for an application
Inputs: notes (required), rating (required), applicationId (required), interviewStepId.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct resource and action: searching candidates, getting candidate/application details, listing applications, submitting/retrieving feedback, listing jobs, getting interview schedules, and adding notes. No two tools have overlapping purposes, making selection unambiguous.
All tools follow a consistent verb_noun pattern in snake_case (e.g., search_candidates, get_candidate, list_jobs). Verbs like search, get, list, submit, and add are clearly differentiated and used predictably across the set.
Nine tools is well within the ideal 3-15 range for an ATS integration. The scope is tight and focused on recruiting workflows—searching, viewing, feedback, and scheduling—without unnecessary bloat or missing core actions.
The tool surface covers the main candidate and application lifecycle: search, retrieve, list, provide feedback, view interview schedule, and add notes. Minor gaps exist, such as no job detail retrieval or application status updates, but these are not critical for common recruiting tasks.
Maintenance
Related MCP Connectors
Unofficial Ashby MCP Pack — wraps the Ashby ATS API
Search Recruitee candidates, jobs, pipelines and interviews, and add notes, tags and tasks.
Ashby ATS job scraper pulls live postings via API with team filtering.
Find your next great hire. Review candidates and manage hiring through your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA server implementation that enables LLMs to interact with Ashby's Applicant Tracking System, allowing management of candidates, jobs, applications, interviews, and analytics through the Model Context Protocol.16MIT
- AlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that enables LLMs to interact with Ashby's Applicant Tracking System for managing candidates, jobs, applications, and interviews. It supports data operations, batch processing, and access to pipeline analytics and reporting.MIT
- AlicenseAqualityDmaintenanceConnects Claude to the Ashby ATS to manage the hiring pipeline through natural conversation. It enables users to browse jobs, manage candidate profiles, track applications, and coordinate interview stages.245MIT
- AlicenseNot gradedqualityDmaintenanceConnects your Ashby recruiting data to Claude, enabling natural language queries and management of candidates, applications, jobs, interviews, offers, and team information.ISC