Ashby MCP server

Connect Ashby to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Ashby MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get candidate tool in Ashby
  • Use the create job tool in Ashby
  • Use the update job tool in Ashby
  • Use the manage interview schedule tool in Ashby
  • Use the update candidate tool in Ashby
  • Use the create application tool in Ashby

Supported Tools

get_candidate

Get Candidate

Gets the exact candidate by ID or by an unambiguous email/name search. Multiple matches require a refined search or an exact ID; visibility depends on API-key permissions.

create_job

Create Job

Creates a new job in Ashby with a title, required location and department/team IDs, and an optional default interview plan. Use list_organization to discover the location and department. Returns the created job's ID and basic details.

update_job

Update Job

Updates a job's details, status, or compensation. Supports changing the title, location, department, status, and compensation in a single call.

manage_interview_schedule

Manage Interview Schedule

Creates, updates, cancels, or lists interview schedules in Ashby. Use this tool to coordinate interview scheduling for candidates in the hiring pipeline.

update_candidate

Update Candidate

Updates a candidate's profile in Ashby. Supports changing name, email, phone, social links, adding tags, creating notes, and assigning to projects. Multiple operations can be performed in a single call.

create_application

Create Application

Creates a new application for a candidate on a job in Ashby. An application represents a candidate's progression through the hiring pipeline for a specific job. Optionally specify an interview plan, starting stage, source, or credited user.

list_applications

List Applications

Lists applications with pagination or retrieves detailed information about a specific application. Applications represent a candidate's progress through the hiring pipeline for a particular job.

list_organization

List Organization Data

Discovers departments, locations, users, sources, archive reasons, tags, candidates, projects, custom fields, interview plans/stages/interviews and hiring roles needed by the existing tools. Returns one page where pagination is supported; user search requires an exact email.

list_jobs

List Jobs

Lists one native job page, reads an exact jobId, or performs bounded title search. Status-only filtering uses the list endpoint. Combined title/status filtering applies status to the bounded search results.

set_custom_field

Set Custom Field

Sets a custom field value on an Ashby entity. Use the list organization tool with `resourceType` set to `custom_fields` to discover definitions and their supported object types. Offer fields use manage_offer forms; this endpoint does not support Offer.

update_application

Update Application

Updates an existing application in Ashby. Supports multiple actions: change the interview stage (optionally with an archive reason), change the application source, transfer the application to a different job, and add or remove hiring team members. Multiple actions can be performed in a single call.

manage_offer

Manage Offer

Reads/lists offers, submits native offer forms, starts a version in an existing prepared process, or force-approves the exact latest version. Process, form, application and version IDs are distinct; no approval or delivery is implied by form submission.

create_candidate

Create Candidate

Creates a candidate with a full name and primary personal email/phone. Social links are set with a separate documented update; these operations are not atomic. Other legacy contact types are rejected before writes.

download_file

Download Candidate or Offer File

Prepares a downloadable candidate file, resume or offer document using its exact provider file handle. Requires candidatesRead. Ashby-generated demo files may not be downloadable.

get_current_api_key

Get Current API Key Identity

Shows the connected API key title, creation time, endpoint permissions and observed API version. Requires apiKeysRead. It does not identify a human user or reveal the key.

Connect Ashby to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Ashby in Metorial. In your Metorial portal, enable the Ashby MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Ashby tools.

Run Ashby through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Ashby and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Ashby tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Ashby

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Google Calendar

Create, read, update, and delete calendar events and calendars. Manage attendees, recurring events, and reminders. Check free/busy availability for scheduling. Share calendars and control access permissions. Create events from natural language text with quick add. Manage special event types like focus time, out of office, and working location. Subscribe to or remove calendars from a user's calendar list. Sync calendar changes incrementally.

Linkedin

Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.

Calendly

List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.

Google Meet

Create and manage Google Meet meeting spaces, configure access settings, moderation modes, and auto-artifacts like recordings and transcripts. Add, list, and remove space members with roles such as co-host. Retrieve conference records including participant details, join/leave times, and session history. Access meeting artifacts including recording metadata, transcript entries with speaker and timestamp data, and smart notes.

Savvycal

Create, manage, and cancel scheduled events via shareable scheduling links. List and create scheduling links with configurable durations, custom fields, and availability settings. Manage automated workflows with actions and rules attached to scheduling links. Register and manage webhooks for real-time notifications on event lifecycle changes, attendee updates, meeting poll responses, and workflow triggers. Retrieve user information and supported time zones. Supports paid event checkout tracking, meeting polls, and custom event metadata.

Technical notes for Ashby

Read and manage candidates, applications, jobs, offer forms and interview schedules. Discover required organization resources, inspect the connected API key and download provider files.

Frequently asked questions

Common questions about connecting Ashby to AI agents with Metorial.

  1. How many tools does the Ashby MCP server have?
    The Ashby MCP server exposes 15 tools, including Get Candidate, Create Job, Update Job. Each one is governed and traced through Metorial.
  2. Ashby exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Ashby MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Ashby and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Ashby MCP server yourself or use the hosted gateway.

Connect Ashby to production AI agents

See how Metorial gives your team governed access to Ashby, with tracing and security controls built in.