# How to connect Ashby to Claude with the Ashby MCP server (https://www.hyreflow.ai/blog/ashby-mcp-connect-ashby-to-claude)

By Niklas Huetzen, Co-founder, hyreflow. Published 9 Nov 2026.

> To connect Ashby to Claude, an Ashby Org Admin turns on MCP Server under Admin > Organization Setup > Opt-In Features. Each user then adds Ashby from Claude's Connectors Directory and signs in. Ashby's server, in open beta on every Ashby plan, reads candidates, jobs and interviews, adds notes and moves stages (Ashby docs, 30 Oct 2026). hyreflow adds candidates from outside Ashby, found in people databases, with personal emails.

- Ashby's MCP server works on every Ashby plan except Analytics-only, once an Org Admin switches it on.
- Claude signs in as you, so it sees only the candidates and roles your Ashby permissions show.
- Ashby's server reads your pipeline and moves stages. Its tools do not create jobs or find people outside Ashby (30 Oct 2026).
- Archiving a candidate through Claude still sends any automated archive email you have set up in Ashby.
- In a hyreflow run on 30 Oct 2026, ten London backend engineers and three personal emails cost 6.4 credits.

Ashby, an applicant tracking system (ATS) used by in-house talent teams, launched its own MCP server in open beta on 29 June 2026. That server is now the direct way to put your Ashby pipeline inside Claude, Anthropic's AI assistant.

## Does Ashby have its own MCP server? [#does-ashby-have-its-own-mcp-server]

Yes, Ashby has its own MCP server, in [open beta since 29 June 2026](https://www.ashbyhq.com/product-updates/mcp). Ashby's [help docs](https://docs.ashbyhq.com/ashby-mcp-server-beta) list it on the Foundations, Legacy Plus, Plus and Enterprise plans, but not on Analytics-only ones (page updated 22 Oct 2026, checked 30 Oct 2026).

The Ashby MCP server lives at `https://mcp.ashbyhq.com/mcp/v1` and works with any MCP client, including Claude, ChatGPT and Cursor. Anthropic lists it in Claude's Connectors Directory with an "Anthropic verified" badge ([Claude Marketplace](https://claude.com/marketplace/connectors/ashby), 30 Oct 2026).

Every person signs in with their own Ashby account through OAuth. Ashby's docs say: "A user not involved in a hiring process cannot query candidates or roles they do not otherwise have access to."

<Callout
  type="definition"
  title="MCP (Model Context Protocol)"
  facts="[
  { label: 'Ashby server status', value: 'Open beta since 29 Jun 2026' },
  { label: 'Ashby plans', value: 'All except Analytics-only' },
  { label: 'Sign-in', value: 'OAuth, one per user' },
  { label: 'Checked', value: '30 Oct 2026' },
]"
>
  An open standard, created by Anthropic, that lets an AI assistant such as Claude call outside tools and data. An MCP server is the service on the other end. Ashby's server gives Claude tools that read and change records in your Ashby account.
</Callout>

## How do you connect Ashby to Claude, step by step? [#how-do-you-connect-ashby-to-claude-step-by-step]

Connecting Ashby to Claude takes two switches: an Ashby Org Admin enables the server, then each user connects their own account in Claude. On Claude Team and Enterprise, a Claude Owner first adds the connector for the organisation (Anthropic, 30 Oct 2026).

Ashby's connector runs from a web address. [Anthropic's help centre](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities) says web connectors are available to all Claude users (checked 30 Oct 2026). Custom connectors, added by URL, work on Free, Pro, Max, Ultra, Team and Enterprise, with one allowed on Free (30 Oct 2026).

<Steps>
  <Step title="Switch on the server in Ashby">
    An Ashby Org Admin opens Admin > Organization Setup > Opt-In Features and turns on MCP Server. Ashby's docs say Elevated Access users can then connect their own accounts.
  </Step>

  <Step title="Add Ashby for the team in Claude (Team and Enterprise only)">
    A Claude Owner or Primary Owner opens Organization settings > Connectors, clicks Browse connectors, selects Ashby and clicks "Add to your team". Each member still signs in on their own.
  </Step>

  <Step title="Find Ashby in Claude">
    Open Customize > Connectors, search for Ashby, select it and click Connect.
  </Step>

  <Step title="Sign in to Ashby and approve">
    Log in to Ashby if asked, then select Approve in the MCP access window.
  </Step>

  <Step title="Switch Ashby on in a chat">
    Click the "+" button at the lower left of the chat, open Connectors and toggle Ashby on for that conversation.
  </Step>
</Steps>

A Claude Owner on Team or Enterprise can set each Ashby tool to Always allow, Needs approval or Blocked for everyone (Anthropic, 30 Oct 2026). With the write tools on Needs approval, a person confirms every stage change.

## What can the Ashby MCP server do in Claude, and what can it not do? [#what-can-the-ashby-mcp-server-do-in-claude-and-what-can-it-not-do]

The Ashby MCP server reads most of what sits in your Ashby account and takes four actions. It can create a candidate, add a note, move an application's stage and add a candidate to a job. Ashby's help page lists these tools (updated 22 Oct 2026, checked 30 Oct 2026).

| What you ask Claude                                                               | Ashby tool                                         | Note from Ashby's docs                         |
| --------------------------------------------------------------------------------- | -------------------------------------------------- | ---------------------------------------------- |
| Find a candidate, job or application by name                                      | `search_records_by_name`                           | The starting point for most questions          |
| Count or filter applications, jobs, openings, interviews or offers                | `filter_records`                                   | Can return a total instead of a list           |
| Read a candidate's resume (CV), feedback, emails, notes and interview transcripts | `get_candidate`                                    | Limited to what you can see in Ashby           |
| See this week's interviews and get a prep brief                                   | `get_upcoming_interviews`, `get_interview_details` | Brief covers background, panel and hiring team |
| See the pipeline by stage, across several jobs                                    | `get_job_pipeline`                                 | Compares jobs side by side                     |
| List the scorecards and approvals you owe                                         | `get_pending_tasks`                                | Your own tasks only                            |
| Create a candidate                                                                | `create_candidate`                                 | Name and contact details                       |
| Add a note to a candidate                                                         | `add_note_to_candidate`                            | Drafted for you to confirm before saving       |
| Move an application to another stage, or archive it                               | `change_application_stage`                         | Archive reason required                        |
| Add a candidate to a job                                                          | `consider_candidate_for_job`                       | Creates an application at the first stage      |

Ashby's documented tools do not create or open jobs, publish job postings, schedule interviews or create offers (30 Oct 2026). None of them searches for people outside your Ashby account. Ashby says it adds tools over time and that tool inputs and outputs "may change without notice".

Claude's directory page says the Ashby connector can send emails from the conversation. Neither the directory's own tool list nor Ashby's help page shows an email tool (both checked 30 Oct 2026).

<Callout type="warning">
  Archiving through Claude has the same effect as archiving in Ashby. Ashby's docs say automatic activities on the Archived stage still run, so the candidate "still gets any automated archive email". Upcoming scheduled interviews are not cancelled.
</Callout>

### First prompts to try with the Ashby connector in Claude [#first-prompts-to-try-with-the-ashby-connector-in-claude]

The first useful prompts with the Ashby connector are pipeline questions: interviews, stage counts and the tasks you owe. Ashby's own customer data shows the volume behind those questions.

<Stat value="291" source="Ashby, Recruiter Productivity, 2026 Talent Trends Report (28 Apr 2026)" href="https://www.ashbyhq.com/talent-trends-report/reports/2023-recruiter-productivity-trends-report">
  applications per hire for the average recruiter on Ashby, against roughly 100 in early 2021. Ashby measured 109M applications and 247K jobs on its platform from January 2021 to March 2026.
</Stat>

Ashby Academy runs an Ashby MCP Server course with starter prompts for daily recruiting briefs, debrief prep and headcount planning. The prompt below follows the daily brief and uses Ashby's tools only. Turning a daily prompt into a reusable one is the subject of Claude skills for recruiters.

Prompt (Claude):

> Using Ashby, give me my recruiting brief for today. List my interviews this week with a two-line prep note on each candidate, show the pipeline by stage for our open Engineering roles, and list the scorecards and approvals I owe.

What comes back: By Ashby's tool descriptions: your interviews this week with names, job titles and times, a stage-by-stage count per Engineering job, and your pending tasks. This prompt was not run for this guide, because hyreflow has no Ashby account to test on.

## What are the other ways to connect Ashby to Claude? [#what-are-the-other-ways-to-connect-ashby-to-claude]

Two other routes reach Ashby from Claude: hyreflow, which posts jobs to Ashby, and third-party MCP servers that wrap Ashby's public API. Ashby's own server signs in as you; the other two use an Ashby API key.

### hyreflow's Ashby integration [#hyreflows-ashby-integration]

hyreflow, an AI recruitment assistant that runs inside Claude and ChatGPT as a connector, posts jobs to Ashby. Its [Ashby integration](/tools/ashby) creates a job in Draft, opens it and publishes the posting. It uses your own Ashby API key with the `jobsWrite` permission.

Ashby calls cost 0 hyreflow credits (30 Oct 2026). hyreflow's Ashby connection works on every plan, Free included, where it is capped at 100 requests a month ([plans](/docs/plans), 30 Oct 2026). hyreflow's Ashby integration does not read or write candidates (30 Oct 2026).

hyreflow's Ashby playbook notes one quirk (30 Oct 2026). If opening a job fails on Plus or Enterprise, the organisation probably requires an Opening, Ashby's headcount record, linked to the job first, and hyreflow does not create Openings.

The plays that use hyreflow's Ashby integration are [posting one role to every ATS](/skills/post-one-role-to-every-ats) and [turning a brief into a job advert](/skills/job-ad-from-a-brief).

### Third-party Ashby MCP servers that use an API key [#third-party-ashby-mcp-servers-that-use-an-api-key]

Gumloop, an AI automation platform, hosts an Ashby MCP server that signs in with an Ashby API key. Its page lists 86 tools, interview scheduling and offers among them ([Gumloop](https://www.gumloop.com/connectors/ashby-mcp), 30 Oct 2026).

A [GitHub search for "ashby mcp"](https://github.com/search?q=ashby+mcp\&type=repositories) returned 15 community-built servers the same day. The ones checked run on your own computer, with an API key in a config file.

An Ashby API key acts as a service account for the whole organisation. Ashby's developer docs say an Ashby Admin grants each key read or write access per module ([Ashby](https://developers.ashbyhq.com/docs/authentication), 30 Oct 2026). Keys cannot see confidential jobs unless that is allowed.

[Anthropic adds](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) that a connector using a shared API key "gives everyone who uses it that credential's access."

| | Ashby MCP server | hyreflow | API-key server (Gumloop) |
| --- | --- | --- | --- |
| How it signs in | Your own Ashby login (OAuth) (Ashby docs, seen 30 Oct 2026) | Your Ashby API key, stored in hyreflow | An Ashby API key (Gumloop, seen 30 Oct 2026) |
| Sees only what your Ashby role allows | Yes | What the API key allows | What the API key allows |
| Read candidates and applications | Yes | No | Yes |
| Add notes and move stages | Yes | No | Yes |
| Create, open and publish a job | No | Yes | Create jobs and change their status (Gumloop, seen 30 Oct 2026) |
| Schedule interviews and create offers | No | No | Yes |
| Find new people outside Ashby | No | Yes | No |
| Personal emails and mobiles | No | Yes | No |

Ashby's tools from its help page (updated 22 Oct 2026), Gumloop's from its connector page, hyreflow's from its own docs, all checked 30 Oct 2026. A dash means the capability is not in that route's published tool list on that date.

## How does hyreflow add sourcing and personal emails to an Ashby workflow in Claude? [#how-does-hyreflow-add-sourcing-and-personal-emails-to-an-ashby-workflow-in-claude]

hyreflow adds people from outside Ashby. It searches its own people-data providers for a role, finds personal emails, and gives Claude a list that Ashby's own tools can load. hyreflow runs alongside the MCP servers you already use, so both connectors can be on in one Claude chat.

hyreflow is added to Claude as a custom connector at `https://recruit.hyreflow.ai/api/v2/mcp`; the [hyreflow setup guide](/docs/mcp-setup) has the steps per client. On Claude's Free plan, that takes the one custom connector Free allows (30 Oct 2026).

Inbound applications made up 52% of hires on Ashby in Q1 2026, up from 38% in early 2021, in the same [Ashby report](https://www.ashbyhq.com/talent-trends-report/reports/2023-recruiter-productivity-trends-report). Sourcing matters most on the roles that inbound does not fill.

hyreflow ran the sourcing half on 30 Oct 2026, calling its people search and personal-email lookup with the filters in the prompt below. The search returned 10 of 144 matching profiles for 0.5 credits.

A personal-email lookup on the five closest matches found three for 5.9 credits, one each from contact-data providers [LeadMagic](/tools/leadmagic), [Wiza](/tools/wiza) and [FullEnrich](/tools/fullenrich). The two misses cost nothing.

Prompt (Claude):

> Use hyreflow to find 10 senior backend engineers in London with Python and PostgreSQL and at least five years' experience. Find personal emails for the five closest matches, then give me a table with name, email, LinkedIn URL, current title and employer, ready to add to Ashby.

What comes back: Ten people from 144 matching profiles, five checked for a personal email and three found. The table is ready for Ashby's create\_candidate tool. Figures from a run on 30 Oct 2026; hyreflow's reference rate is $0.10 a credit, slightly less on a paid plan.

The five people checked for an email, anonymised:

| Current title                          | Employer type                   | Personal email    | Credits |
| -------------------------------------- | ------------------------------- | ----------------- | ------- |
| Senior Backend Engineer                | Payments app                    | Not found         | 0       |
| Senior Backend Engineer                | Booking platform                | Found, Wiza       | 1.0     |
| Senior Backend Engineer                | Legal technology firm           | Found, LeadMagic  | 1.1     |
| Senior Backend Engineer                | Fintech start-up                | Found, FullEnrich | 3.8     |
| Senior Applied AI and Backend Engineer | Insurance company's digital hub | Not found         | 0       |

The list still needs a recruiter's read before anything goes into Ashby. Two of the ten did not hold a senior title, and two listed Java or Go with no Python among their skills. hyreflow's free Ashby connection check returned `no_key` on the test workspace, which has no Ashby account.

With Ashby also connected, the same chat can load the table into Ashby. `search_records_by_name` checks for an existing candidate, and `create_candidate` creates a new one. `consider_candidate_for_job` then adds each person to the role.

Prompt (Claude):

> Using Ashby, check each person in this table by name. Show me which ones are already candidates and which are new. Once I approve, create the new ones and consider them for our Senior Backend Engineer job.

What comes back: A list split into existing and new records, then new candidates at the first stage of the job's interview plan after your approval. This half was not run for this guide; it follows Ashby's documented tools.

<Flow
  steps="[
  { title: 'Prompt in Claude', detail: 'role, location, skills' },
  { title: 'hyreflow search', detail: '10 of 144 profiles, 0.5 credits' },
  { title: 'Personal emails', detail: '3 of 5 found, 5.9 credits' },
  { title: 'Your review', detail: 'drop off-target rows' },
  { title: 'Ashby create_candidate', detail: &#x22;Ashby's own server&#x22; },
  { title: 'Ashby job', detail: 'first interview stage', end: true },
]"
  caption="<><b>From a search to an Ashby job.</b> hyreflow figures from a run on 30 Oct 2026; the Ashby steps use Ashby's documented tools and were not run.</>"
/>

<WorksWith tools="['aiark', 'leadmagic', 'wiza', 'fullenrich', 'ashby']" label="Tools in this workflow" />

The full method for a scored list is in [how to turn a job description into a shortlist with Claude](/blog/how-to-turn-a-job-description-into-a-shortlist-with-claude). The search itself is in [how to source candidates with Claude](/blog/how-to-source-candidates-with-claude). For the category, see [what an AI recruitment assistant is](/blog/what-is-an-ai-recruitment-assistant).

For an agency that keeps candidates in a recruitment CRM rather than Ashby, hyreflow covers the same ground there. It [loads a shortlist into your ATS without duplicates](/skills/push-a-shortlist-into-your-ats) and [finds candidates already in your ATS](/skills/match-your-ats-to-a-live-role). Both plays work with Loxo, JobAdder, Recruit CRM, Vincere, Recruiterflow and Atlas (30 Oct 2026).

Neither play covers Ashby as of 30 Oct 2026; the wider list is in [recruiting tools that work with Claude](/blog/recruiting-tools-that-work-with-claude).

<InlineCTA title="Run the sourcing half on a live role" action="Start with 25 free credits" href="/pricing">
  Add hyreflow to Claude next to Ashby and run the prompt above on a role you are hiring for this week.
</InlineCTA>

## Where does connecting Ashby to Claude fall short? [#where-does-connecting-ashby-to-claude-fall-short]

Connecting Ashby to Claude has limits on every route, starting with the beta label on Ashby's server.

<Limits>
  Ashby's server is in open beta, and Ashby says tool inputs and outputs may change without notice. On 30 Oct 2026 it allowed 120 requests a minute per auth token. It also allowed 120 tool units a minute per user, with filter\_records counting as two. hyreflow's Ashby integration posts jobs only and does not read or write candidates. The hand-off above therefore relies on Ashby's tools, which this guide did not test. Personal email coverage is strongest in the US and UK and weaker in the DACH region and Asia.
</Limits>

## Questions about the Ashby MCP server [#questions-about-the-ashby-mcp-server]

### Do I need to be an Ashby admin to use the Ashby MCP server?

An Ashby Org Admin has to switch the server on once. After that, Ashby's docs say users with Elevated Access connect their own accounts (checked 30 Oct 2026).

### Can Claude see Ashby candidates I cannot see myself?

No. The Ashby MCP server signs in as you through OAuth and inherits your Ashby permissions. It cannot return candidates, jobs or other records you cannot already open in Ashby.

### Does the Ashby connector work in ChatGPT?

Yes. Ashby's docs give the ChatGPT route as Settings > Apps, search for Ashby, then Connect (30 Oct 2026). hyreflow also runs in ChatGPT; the steps are in the [hyreflow setup guide](/docs/mcp-setup).

### Does hyreflow push candidates into Ashby?

Not as of 30 Oct 2026. hyreflow's Ashby integration creates, opens and publishes jobs. To load candidates, Claude can pass hyreflow's list to the Ashby MCP server's create\_candidate tool in the same chat.

### Does hyreflow work with Lever the same way?

Yes, for job postings. hyreflow connects to [Lever](/tools/lever), another ATS, with your own Lever API key, minted by a Lever Super Admin. It creates and publishes postings at 0 hyreflow credits (30 Oct 2026).

## Sources

- [Ashby MCP Server (Beta)](https://docs.ashbyhq.com/ashby-mcp-server-beta), Ashby Knowledge Base. Checked 30 Oct 2026
- [Introducing the Ashby MCP Server](https://www.ashbyhq.com/product-updates/mcp), Ashby. Checked 30 Oct 2026
- [Ashby connector](https://claude.com/marketplace/connectors/ashby), Anthropic, Claude Marketplace. Checked 30 Oct 2026
- [Use connectors to extend Claude's capabilities](https://support.claude.com/en/articles/11176164-use-connectors-to-extend-claude-s-capabilities), Anthropic, Claude Help Center. Checked 30 Oct 2026
- [Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp), Anthropic, Claude Help Center. Checked 30 Oct 2026
- [Authentication and API key permissions](https://developers.ashbyhq.com/docs/authentication), Ashby developer docs. Checked 30 Oct 2026
- [Ashby MCP Server](https://www.gumloop.com/connectors/ashby-mcp), Gumloop. Checked 30 Oct 2026
- [Repository search for "ashby mcp"](https://github.com/search?q=ashby+mcp&type=repositories), GitHub. Checked 30 Oct 2026
- [Recruiter Productivity, 2026 Talent Trends Report](https://www.ashbyhq.com/talent-trends-report/reports/2023-recruiter-productivity-trends-report), Ashby. Checked 30 Oct 2026
- [Ashby integration](https://www.hyreflow.ai/tools/ashby), hyreflow. Checked 30 Oct 2026
- [MCP setup, per client](https://www.hyreflow.ai/docs/mcp-setup), hyreflow docs. Checked 30 Oct 2026
- [hyreflow pricing](https://www.hyreflow.ai/pricing), hyreflow. Checked 30 Oct 2026
