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

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