Ashby MCP

Connect your Ashby recruiting data to Claude. Once set up, you can ask Claude things like:

• "Show me all active applications for the Engineering Manager role"
• "Search for candidate Jane Smith"
• "What interview stages does this job have?"
• "List all open job postings"

---

What you'll need

1. Node.js installed on your computer — download it at nodejs.org (click the big green "LTS" button)
2. An Ashby API key — go to Ashby → Settings → Integrations → API Keys → Create a new key
3. Claude Desktop — download at claude.ai/download

---

Setup (5 minutes)

Step 1 — Download this project

Click the green Code button at the top of this page, then click Download ZIP. Unzip it somewhere easy to find, like your Desktop.

Step 2 — Install dependencies

Open Terminal (press Cmd + Space, type "Terminal", press Enter) and run:

cd ~/Desktop/ashby-mcp
npm install

Step 3 — Connect to Claude Desktop

Open this file in a text editor:

~/Library/Application Support/Claude/claude_desktop_config.json

Tip: In Finder, press Cmd + Shift + G, paste the path above, and press Go.

Add the following inside the file. If the file already has content, add this inside the "mcpServers" section:

{
  "mcpServers": {
    "ashby": {
      "command": "node",
      "args": ["/Users/YOUR_NAME/Desktop/ashby-mcp/index.js"],
      "env": {
        "ASHBY_API_KEY": "paste-your-api-key-here"
      }
    }
  }
}

Replace YOUR_NAME with your Mac username and paste your Ashby API key where indicated.

Step 4 — Restart Claude Desktop

Quit Claude Desktop completely and reopen it. You're ready to go!

---

What can it do?

Ask Claude about...	Examples
Candidates	Search, view, create candidates; add notes and tags
Applications	List, filter, and move applications through stages
Jobs	Search and view job details
Job Postings	See published, draft, or closed postings
Interviews	View and cancel interview schedules
Offers	List and view offer details
Your team	Look up users and departments

---

Need help?

Open an issue on this GitHub page and describe what's going wrong — include any error messages you see. OR Email me - Jake (dot) teagle (at) v7labs.com