Workable MCP server

Connect Workable 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.

Deploy WorkableBook a demo

What you can do with the Workable MCP server

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

  • Use the manage candidate tool in Workable
  • Use the list jobs tool in Workable
  • Use the list departments tool in Workable
  • Use the get candidate details tool in Workable
  • Use the list employees tool in Workable
  • Use the manage employee tool in Workable

Supported Tools

manage_candidate

Manage Candidate

Update a Workable candidate or run a candidate lifecycle action: move, copy, relocate, disqualify, revert disqualification, comment, set tags, or add a rating.

list_jobs

List Jobs

List Workable jobs. Filter by state or date, and use the returned shortcode with candidate, application form, question, and stage tools.

list_departments

List Departments

List all departments in the Workable account. Use this to look up department IDs for employee and requisition operations.

get_candidate

Get Candidate Details

Retrieve a Workable candidate by candidate ID. Optionally include the candidate activity feed, files, and current offer details.

list_employees

List Employees

List employees from Workable HR using Workable's query, ordering, limit, and offset parameters. Use memberId when an account token requires member context.

manage_employee

Manage Employee

Get, create, or update a Workable HR employee. Create and update requests are wrapped in Workable's documented { employee } payload, with optional memberId for account-token access.

manage_time_off

Manage Time Off

List time-off categories and requests, create time-off requests, check balances, and approve or reject time-off approvals using Workable's /timeoff endpoints.

create_candidate

Create Candidate

Add a candidate to a Workable job. Workable requires email plus either name or both first and last name; stage is sent as a query parameter and sourced is sent at the request body root.

get_job

Get Job Details

Retrieve a Workable job by shortcode. Use the optional includes for stages, hiring team members, and the application form when the caller needs related setup data.

manage_requisition

Manage Requisitions

List, get, create, update, approve, or reject Workable Hiring Plan requisitions using the documented code/id split: code for get/approve/reject and id for update.

get_account

Get Account Info

Retrieve the configured Workable account information. Use list_members for member lookup; includeMembers remains available as a small convenience.

list_events

List Scheduled Events

Retrieve scheduled Workable events such as calls, interviews, and meetings. Filter by event type, candidate, job shortcode, member, date range, or token context.

list_candidates

List Candidates

List Workable candidates across jobs or filtered by job shortcode, email, or stage. Use this to find candidate IDs for candidate detail and action tools.

list_disqualification_reasons

List Disqualification Reasons

List Workable disqualification reasons. Use the returned IDs with manage_candidate disqualify.

list_candidate_files

List Candidate Files

List file metadata for a Workable candidate. The tool returns Workable file URLs and metadata, not downloaded file content.

list_members

List Members

List Workable members. Use this to find member IDs required by candidate, requisition, employee, and time-off write actions.

list_job_custom_attributes

List Job Custom Attributes

List custom attributes configured for a Workable job.

list_job_questions

List Job Questions

List application questions for a Workable job. Use these question keys when creating or updating candidate answers.

list_work_schedules

List Work Schedules

List Workable work schedules for employee create/update operations.

list_employee_fields

List Employee Fields

List Workable employee fields for HR create/update payload construction.

list_stages

List Stages

List Workable recruitment stages. Provide jobShortcode to get stages for a specific job, or omit it for the account pipeline stages.

get_job_application_form

Get Job Application Form

Retrieve the application form configuration for a Workable job.

list_legal_entities

List Legal Entities

List Workable legal entities for employee create/update operations.

list_account_custom_attributes

List Account Custom Attributes

List account-level custom attributes in Workable.

Connect Workable 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 Workable in Metorial. In your Metorial portal, enable the Workable 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 Workable tools.

Run Workable through the Metorial gateway

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

  • Give Workable and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Workable 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 Workable

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.

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.

Async Interview

Review asynchronous interview campaigns and candidate submissions. List interview jobs, retrieve interview responses with candidate details and recording links, and filter responses by job.

Bamboohr

Read and update visible BambooHR employee records and tables, time off, timesheets, goals and training records. Discover employee IDs, current reports and active applicant statuses. Read company benefit summaries and employee dependents, retrieve applicant tracking data, generate reports and download employee or company files. Permissions and company configuration determine availability.

Breathe Hr

Read employee, absence, sickness, organization, compensation and training records. Create employee and sickness records, request or decide leave, cancel absences, and manage expenses and claims. Discover the connected account and available configuration records.

Brex

Read and manage Brex users, cards, vendors, budgets and spend limits. Inspect card expenses, transactions, accounts and transfer status, download exact receipt files, and initiate explicitly requested vendor payments. Availability depends on the account role, scopes and enabled Brex products.

Technical notes for Workable

Manage recruiting, hiring, and HR processes. Create and track job postings, manage candidates through hiring pipelines, and handle employee records. Create, move, disqualify, and comment on candidates. Manage requisitions with approval workflows. Retrieve offers and scheduled events like interviews. Create and manage departments. Handle employee data, documents, and time-off requests. Build custom careers pages with public job listing endpoints.

Frequently asked questions

Common questions about connecting Workable to AI agents with Metorial.

  1. How many tools does the Workable MCP server have?
    The Workable MCP server exposes 24 tools, including Manage Candidate, List Jobs, List Departments. Each one is governed and traced through Metorial.
  2. Workable 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 Workable MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Workable and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Workable MCP server yourself or use the hosted gateway.

Connect Workable to production AI agents

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

Book a demoDeploy Workable