Workable MCP Server

Official Workable MCP server. Connect AI assistants to live recruiting and HR data: jobs, candidates, pipelines, offers, requisitions, employees, time off, and calendar.

Jobs & HR by Workable OAuth2 active

Connect (Remote Server) Docs

Overview

The Workable MCP Server is a provider-hosted Model Context Protocol endpoint that gives AI assistants direct read and write access to a company's live Workable data. Announced in May 2026, it is one of the first native MCP integrations from a major recruiting platform and is included at no additional cost across all Workable subscription plans. The server is hosted by Workable at https://mcp.workable.com/mcp and authenticates via OAuth2, so there are no API keys to manage and no developer setup required.

The server ships with roughly 38 tools spanning the full scope of recruiting and HR workflows, including jobs, candidates, pipeline stages, offers, requisitions, employees, time tracking, time-off records, departments, background checks, members and permissions, and calendar events. Compatible clients include Claude (Anthropic), ChatGPT (OpenAI), Cursor, and any other MCP-compatible AI tool that supports custom connectors.

A key design choice is that the server respects each user's existing Workable permissions. Every AI session is scoped to the authenticated user's role and job assignments, so the AI can only read or act on data the user is already authorized to see. This makes it safe to roll out across recruiting teams without re-provisioning access.

Tools

Tool	Description
`get_jobs`	List jobs in the Workable account with filters such as status and department.
`list_public_jobs`	Retrieve publicly listed job postings for the account's careers page.
`get_stages`	Get pipeline stages configured for a job or account.
`get_candidates`	List or search candidates, with filters for job, stage, or query.
`get_requisitions`	List requisitions, optionally filtered by status or creator.
`get_events`	Retrieve calendar events such as interviews and scheduled meetings.
`get_recruiters`	List recruiters and account members involved in hiring.
`get_members`	List account members.
`invite_member`	Invite a new user to the Workable account.
`enable_member`	Activate a previously disabled member account.
`update_member`	Update role, permissions, or job assignments for a member.
`list_permission_sets`	List configured permission sets in the account.
`get_account`	Return details for the authenticated Workable account.
`get_accounts`	List accounts accessible to the authenticated user.
`get_legal_entities`	List legal entities configured for the organization.
`create_employee`	Create a new employee record in Workable HR.
`get_employee`	Retrieve an employee profile by ID.
`update_employee`	Update fields on an existing employee record.
`list_employees`	List employees with optional filters.
`list_employee_fields`	Return the schema of employee fields available in the account.
`upload_employee_documents`	Attach documents to an employee record.
`create_department`	Create a new department.
`update_department`	Update a department's name or parent.
`merge_department`	Merge one department into another.
`delete_department`	Delete a department.
`list_departments`	List all departments in the org.
`list_time_off_balances`	Return time-off balances for employees.
`list_time_off_categories`	List configured time-off categories such as vacation or sick leave.
`list_work_schedules`	List work schedules configured for employees.
`get_background_check_providers`	List integrated background check providers.
`get_background_check_packages`	List available background check packages.
`update_background_check_status`	Update the status of a candidate's background check.
`list_custom_attributes`	List custom attributes defined on candidates or employees.
`list_disqualification_reasons`	List configured candidate disqualification reasons.
`get_subscriptions`	List webhook subscriptions for the account.
`delete_subscription`	Delete a webhook subscription.

Setup Guide

Prerequisites

An active Workable account. The MCP server is available on all subscription plans at no extra cost.
An MCP-compatible AI client that supports remote servers with OAuth2, such as Claude (Desktop or web Connectors), ChatGPT, or Cursor.
Your Workable user role determines which tools and data the AI can access. Permissions are inherited from your existing account role.

Server URL

https://mcp.workable.com/mcp

Claude (Custom Connector)

Open Claude settings and go to Connectors.
Click "Add custom connector".
Name it "Workable" and paste the server URL https://mcp.workable.com/mcp.
Click Connect. You will be redirected to Workable to sign in via OAuth2 and approve access.
Once authorized, the Workable tools become available in your Claude conversations.

Cursor / VS Code style config

If your client uses an mcpServers JSON config, add:

{
  "mcpServers": {
    "workable": {
      "url": "https://mcp.workable.com/mcp"
    }
  }
}

On first use, the client will open a browser window to complete the Workable OAuth2 flow. No API keys or environment variables are required.

ChatGPT

In ChatGPT, add Workable as a connector under the developer or connector settings, point it at https://mcp.workable.com/mcp, and complete the OAuth2 sign-in.

Notes

Authentication is OAuth2 only. There is no API key configuration.
The AI session is scoped to the signed-in user's role and job assignments. Tools that the user is not authorized to call will be unavailable or return an authorization error.
Refer to the official setup walkthrough at the Workable help center and API reference (workable.readme.io/reference/workable-mcp-server).

Use Cases

Ask an AI assistant to summarize the active candidate pipeline for a specific role, including stage counts and recent movement.
Have an agent draft and send move-stage actions, comments, or disqualification updates on candidates while a recruiter reviews them.
Automate HR admin tasks such as creating new employee records, uploading onboarding documents, and assigning departments.
Build a recruiting copilot that answers questions like "how many open requisitions in Engineering?" or "who is interviewing this week?" using live Workable data.
Manage time-off operations by querying balances, categories, and schedules to answer manager questions without leaving the chat.

Example Prompts

"List all open jobs in the Engineering department and show me how many candidates are in each pipeline stage."
"Find candidates for the Senior Product Manager role who are stuck in the Phone Screen stage for more than 7 days."
"Create a new employee record for Jane Doe, email jane@acme.com, department Marketing, start date next Monday."
"What time-off balances does employee 12345 have remaining this year, by category?"
"Invite alex@acme.com to Workable as a Hiring Manager and assign them to the Backend Engineer job."

Pros

Official, vendor-hosted server with no self-hosting, no API keys, and OAuth2 sign-in.
Broad coverage across recruiting and HR: jobs, candidates, requisitions, employees, departments, time off, background checks, and webhooks.
Honors existing Workable permissions, so AI access matches each user's role and job assignments.
Included at no additional cost on all Workable subscription plans.

Limitations

Provider-hosted only. There is no open-source repo to inspect, fork, or self-host.
Capabilities are tied to the user's Workable role, so admin-only actions are not available to limited users.
Public documentation of the exact tool list is sparse; tool names and parameters can change as Workable iterates on the server.

Alternatives

Recruitee MCP server for teams on Recruitee instead of Workable.
Greenhouse or Lever via generic API gateways such as Composio or Pipedream MCP, where no native MCP server exists yet.
Workable REST API used directly through a custom MCP server if you need access beyond what the hosted server exposes.