Workable MCP server
35 operations0 webhooks
Recruiting and HR in Workable - jobs, candidates, hiring team members, departments, employees, time off and webhook subscriptions, plus the public job board of any Workable careers page.
Try Workable with your agent
Connect Workable, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Workable on my account, then run one read-only example and show me the result.
Workable tools and triggers
Tools are what your agent can do in Workable through Corsair's MCP server. Triggers are the Workable events a routine can start from.
Departments
- CreateWrite
Create a department
departments.create
- DeleteDestructive
Delete a department
departments.delete
- ListRead-only
List all departments
departments.list
- MergeDestructive
Merge a department into another department
departments.merge
- UpdateWrite
Update a department's name or parent
departments.update
Employees
- CreateWrite
Create an employee in draft or published state
employees.create
- GetRead-only
Get a specific employee by ID
employees.get
- ListRead-only
List/search employees
employees.list
- UpdateWrite
Update an employee's details
employees.update
- Upload DocumentsWrite
Upload documents for an employee
employees.uploadDocuments
Members
- EnableWrite
Reactivate a deactivated member
members.enable
- InviteWrite
Invite a new member by email
members.invite
- ListRead-only
List account members
members.list
- UpdateWrite
Update a member's roles or collaboration rules
members.update
Subscriptions
- CreateWrite
Subscribe to a candidate or employee webhook event
subscriptions.create
- DeleteDestructive
Delete a webhook subscription
subscriptions.delete
- ListRead-only
List webhook subscriptions
subscriptions.list
Accounts
- GetRead-only
Get account metadata by subdomain
accounts.get
- ListRead-only
List all Workable accounts accessible to the authenticated token
accounts.list
Candidates
- ListRead-only
List candidates across all jobs
candidates.list
Custom Attributes
- ListRead-only
List custom attributes configured on the account
customAttributes.list
Disqualification Reasons
- ListRead-only
List disqualification reasons
disqualificationReasons.list
Employee Fields
- ListRead-only
List employee field definitions
employeeFields.list
Events
- ListRead-only
List scheduled events
events.list
Legal Entities
- ListRead-only
List account legal entities
legalEntities.list
Permission Sets
- ListRead-only
List permission sets
permissionSets.list
Public Jobs
- ListRead-only
List an account's public job postings (no authentication required)
publicJobs.list
Public Locations
- ListRead-only
List the locations of an account's public jobs with per-country counts (no authentication required)
publicLocations.list
Recruiters
- ListRead-only
List external recruiters
recruiters.list
Requisitions
- ListRead-only
List requisitions
requisitions.list
Stages
- ListRead-only
List recruitment pipeline stages
stages.list
Timeoff Balances
- ListRead-only
List employee time-off balances
timeoffBalances.list
Timeoff Categories
- ListRead-only
List time-off categories
timeoffCategories.list
Work Schedules
- ListRead-only
List work schedules
workSchedules.list
Jobs
- ListRead-only
List jobs
jobs.list
Connect Workable to Claude, ChatGPT or Cursor
- 1
Connect Workable in Corsair
Add your Workable API key once in Corsair. Corsair stores the credential encrypted and makes the Workable API calls for your agent, so it never goes into a prompt or a config file. Connect Workable
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Workable. On a ChatGPT personal plan, connect Workable here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Workable's read and write operations run right away and its 3 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/workable, add the Workable plugin, and connect with an API key. Then call methods like corsair.workable.api.accounts.get() from your app. Corsair syncs data per tenant.
Yes. Workable requires an API key from your Workable account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Workable, GitHub, Notion, Stripe, and the rest. Trigger Workable from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for recruiting and hr in workable - jobs, candidates, hiring team members, departments, employees, time off and webhook subscriptions, plus the public job board of any workable careers page. Common builds include sync jobs, admin tooling, and agents that call Workable APIs from your backend. Local DB entities let you query synced Workable records without hitting the API on every read.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Workable API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/workable in the open repo. When Workable ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Workable data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Workable data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Workable on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 3 destructive Workable operations. You can change a link's mode at hub.corsair.dev/me.