ashby-mcp

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

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