Skip to main content
Glama
ashby-mcp

ashby-mcp

by antonber

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-mcp

Or clone and build locally:

git clone https://github.com/antonber/ashby-mcp.git
cd ashby-mcp
npm install
npm run build

Configuration

1. Get your Ashby API Key

  1. Log into Ashby

  2. Go to Settings → API Keys

  3. 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_candidates

Search for candidates by name or email

get_candidate

Get detailed candidate information

list_candidate_applications

List all applications for a candidate

get_application

Get details about a specific application

submit_feedback

Submit interview feedback with rating and notes

get_application_feedback

Get all feedback for an application

list_jobs

List jobs (filterable by status)

get_interview_schedule

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 candidate

  • yes - Good candidate, proceed

  • lean_yes - Some positives, worth discussing

  • lean_no - Some concerns, discuss with team

  • no - Does not meet bar

  • strong_no - Clear no

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT

Available Tools

9 tools
add_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

    A3.6/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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.
      16
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      An 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects your Ashby recruiting data to Claude, enabling natural language queries and management of candidates, applications, jobs, interviews, offers, and team information.
      ISC