Connect Workable to ChatGPT to find recruiting and HR information and take actions in your Workable account through conversation. The Workable Model Context Protocol (MCP) server provides tools for jobs, candidates, employees, requisitions, offers, time off and more.
This guide covers connecting through the official Workable connector available in ChatGPT.
Before you start
- An active Workable account and a user with access to the information and actions you want to use.
- Access to ChatGPT on the web with the Workable connector available for your account.
- Workspace policies that permit this connection. If the option is missing, check with your ChatGPT workspace administrator.
- A browser that allows the Workable authorization window.
The MCP server is available on all Workable subscription tiers. HR tools require the corresponding Workable products to be enabled on your account.
The assistant’s access depends on the signed-in user’s Workable permissions. It can only access information and perform actions available to that user in Workable.
Setting up the connection
- Open ChatGPT on the web and go to Settings > Plugins.
- Browse the directory and search for Workable.
- Toggle on the official Workable MCP Server connector.
- Sign in to your Workable account in the authorization window.
- Review the requested permissions and authorize the connection.
The official connector handles the server configuration and OAuth sign-in.
In a supported ChatGPT conversation, type @ and select Workable from the available apps. Then describe what you want to do.
Testing the connection
Start a new conversation with Workable enabled and send:
Use Workable to list the accounts I can access. Call get_accounts first, then use my chosen account’s subdomain as the account argument on subsequent calls. Show the open jobs in that account.
If you have access to multiple Workable accounts, specify which one to use. Check the tool activity for get_accounts, followed by get_jobs, and compare the results with Workable.
Once connected, you can also try:
- “Which candidates applied for the Senior Backend Engineer role this week, and where are they in the pipeline?”
- “Show me the requisitions waiting on my approval.”
- “Who is out of office in the Berlin office next month?”
Results depend on your permissions, enabled products and available tools. Review the record and requested change before approving an action that updates Workable.
Troubleshooting the connection
- I cannot find or connect the Workable connector
Check that you are using the intended ChatGPT account and workspace. Connector availability depends on your plan, region and workspace settings. If Workable is unavailable or disabled by your administrator, ask your workspace administrator to enable it.
- ChatGPT does not use Workable
Confirm Workable is connected under Settings > Plugins. In a supported conversation, select Workable using @ and ask explicitly to use it. Complete any sign-in or approval prompts.
- The expected account or information is missing
Ask the assistant to call
get_accountsagain and select the correct account subdomain. Check that the signed-in Workable user can see the same information directly in Workable and that the required product is enabled.
- The connection fails or a Workable tool returns an error
-
- 401 Unauthorized: Reconnect and sign in to Workable again.
- 403 Forbidden: Check your Workable permissions and enabled products.
- 404 Not found: Check the account subdomain and record.
- 409 Conflict: Check the record’s current state before retrying.
- 422 Unprocessable: Check the supplied values against the options in Workable.
- 429 Rate limited: Wait briefly before trying again.
If an OAuth redirect URI mismatch appears, contact Workable Support with the error and redirect URI. Do not include passwords or access tokens.
For the full list of supported tasks, see Using the Workable MCP server to connect to AI assistant.
For platform details, see OpenAI’s guide to connecting and managing app accounts.