Using the Workable MCP server to connect to AI assistant

The Workable MCP (Model Context Protocol) server lets you connect your AI assistant directly to your Workable account. Once connected, you can manage recruiting and HR tasks through natural language — asking your AI assistant to pull candidate lists, move applicants through the pipeline, approve requisitions, check time-off balances, and more, without leaving your AI tool.

This article covers what you can do with the Workable MCP server and how to get connected.

Before you begin

To use the Workable MCP server, make sure you have:

An active Workable account
An AI client that supports MCP, such as Claude, Cursor, or any other MCP-compatible tool

The Workable MCP server uses OAuth2 for authentication. You'll sign in with your existing Workable credentials when connecting — no separate API key is required for the initial setup.

Connect the Workable MCP server

To connect the Workable MCP server to your AI client, follow these steps:

Open your AI client's MCP configuration settings. Depending on your tool, this may be a settings menu, a configuration file, or a connector marketplace.
Add a new MCP server using the following URL:
https://mcp.workable.com/mcp
When prompted, sign in with your Workable account credentials to authorize the connection via OAuth2.
Once authenticated, your AI assistant will have access to your Workable data and can start performing actions on your behalf.

Important: The actions your AI assistant can take through MCP are governed by your Workable account permissions. It can only access data and perform actions that your user account is authorized to do.

What you can do with the Workable MCP server

Once connected, your AI assistant has access to over 40 tools across your Workable account. Here's what you can do, organized by area:

Jobs	List jobs filtered by status (published, draft, archived, closed) View details for a specific job Check a job's pipeline stages and application form See which team members and external recruiters are assigned Review activity logs for any job Access custom attributes configured for jobs
Candidates	List and filter candidates across your pipeline View full candidate profiles and activity history Move candidates between pipeline stages Disqualify candidates with a reason Add comments (with visibility controls) or ratings Create new candidates or add them to the talent pool Retrieve associated offers for a candidate
Offers	View offer details for any candidate Approve pending offers Reject offers, with an optional reason
Requisitions	List requisitions and filter by status View details of a specific requisition Create new headcount requisitions (with job title and salary info) Approve or reject requisitions
Pipeline & Account	View your configured recruitment stages List account members Check configured disqualification reasons Access account-level custom attributes
Employees	Search and list employees View individual employee profiles
Events	List upcoming or past events (calls, interviews, meetings) View details for a specific event
Time Off	View time-off requests within a date range Check employee leave balances See your configured time-off categories

Example prompts

Here are a few things you can ask your AI assistant once connected:

"Show me all candidates in the final interview stage for the Senior Engineer role."
"Move Jane Smith to the Offer stage in the Product Manager job."
"What time-off requests are pending for this month?"
"Create a new requisition for a Customer Support Specialist in Athens."
"Approve the offer for Alex Johnson."
"List all published jobs and their pipeline stage counts."

Multi-account support

If you manage multiple Workable accounts, the MCP server supports connecting to more than one account.

FAQs

Which AI assistants are compatible with the Workable MCP server?: Any AI client or tool that supports the Model Context Protocol (MCP) can connect to the Workable MCP server. This includes Claude, Cursor, and other MCP-compatible tools. Check your AI tool's documentation to confirm MCP support and to find configuration instructions specific to that client.

What level of Workable access do I need?: You need an active Workable profile. Once connected, the tools available to your AI assistant will reflect your individual Workable permissions — it cannot access data or perform actions beyond what your account is authorized to do.

Is my Workable data secure when using MCP?: The Workable MCP server uses OAuth2 authentication, meaning your credentials are never stored by your AI client. Your AI assistant only has access to data within your Workable account, and all actions are performed under your user identity and permissions.

Can my AI assistant take actions in Workable, or only read data?: Both. The Workable MCP server supports read operations (listing jobs, viewing candidate profiles, checking time-off balances) as well as write operations (moving candidates, creating requisitions, approving offers, adding comments). Always review what your AI assistant is about to do before confirming actions that modify data.

I'm having trouble connecting. What should I do?: Make sure you're using the correct server URL (https://mcp.workable.com/mcp) and that you have access in Workable. If the issue persists, consult your AI client's MCP setup documentation or contact Workable Support.