Workable
Workable is an all-in-one HR software platform that streamlines hiring, employee data management, time tracking, and payroll.
Verdict
Common use cases
- Pull candidate pipeline status during standup
- Draft offer letters with live candidate data
- Audit department headcount before budget reviews
- Kick off background checks from chat
- Sync interview schedules with team calendar
Integration
- Vendor
- Workable
- Category
- developer-tools
- Auth
- OAUTH2
- Tools
- 21
- Composio slug
workable
Tools
- Create Department
Tool to create a department in your account. use when you need to add a new department for organizing teams under your workable account.
- Delete Departmentdestructive
Tool to delete a department. use when removing an obsolete or restructured department after confirming dependent resources.
- Enable Member
Tool to restore a deactivated member. use after confirming the member is currently deactivated.
- Get Account
Tool to return the specified account. use when you need account metadata by subdomain after listing available accounts.
- Get Accounts
Tool to retrieve a collection of all accounts you have access to. use when you need to list your workable accounts after authentication.
- Get Background Check Packages
Tool to retrieve a list of available background check packages from a specified provider. use after identifying the provider to view available package options.
- Get Background Check Providers
Tool to retrieve a list of available background check providers. use after confirming valid authentication to list integrated background check services.
- Get Candidates
Tool to retrieve a list of all candidates across jobs. use when you need to aggregate candidate data across your organization.
- Get Events
Tool to retrieve a collection of events scheduled in the account. use when you need to list all upcoming or past calls, interviews, or meetings.
- Get Jobs
Tool to retrieve a list of jobs from your workable account. use after validating account authentication before managing job postings.
- Get Legal Entities
Tool to retrieve a collection of your account legal entities. use after confirming valid authentication and enabling employee management.
- Get Members
Tool to retrieve a list of your workable account members. use after confirming valid authentication to fetch collaborators, admins, or reviewers.
- Get recruiters
Tool to retrieve external recruiters. use when you need to fetch all external recruiters for your account after confirming the r jobs scope.
- Get Requisitions
Tool to retrieve a collection of requisitions in the account. use after authentication succeeds.
- Get Stages
Tool to retrieve a collection of your recruitment pipeline stages. use when you need to list all available stages before managing candidates or pipelines.
- Get Subscriptions
Tool to list all active subscriptions. use after verifying webhooks configuration to ensure subscriptions are active.
- Invite Member
Tool to invite a member to your workable account. use when sending an invitation email.
- Merge Department
Tool to merge a department into another. use after confirming both department ids and optional force flag.
- Post Background Check
Tool to inject background check results directly into the candidate's timeline. use after a background check status changes to push results and attachments into workable.
- Update Department
Tool to update an existing department in your account. use when renaming a department or changing its parent after confirming its id.
- Update Member
Tool to update a member's details. use when you need to modify information of an existing member after confirming the id.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations > Browse MCP Servers. 2. Find Workable in the directory and click Connect. 3. You'll be redirected to Workable's OAuth consent screen — sign in with an account that has admin or hiring manager permissions. 4. Grant the requested scopes: read and write access to jobs, candidates, members, departments, and account metadata. 5. After authorization, Switchy redirects you back and confirms the connection is live. 6. Open any Space, type '@Workable get candidates' and send — if you see a candidate list or a structured response, the integration is working. 7. Use '@Workable' followed by a task description to invoke any of the 21 available tools inside your conversations.
What teammates see: by default, memories from Workable are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Open Roles
@Workable show me all open job postings in our account, including title, department, and number of candidates in each stage.Open in a Space →
Candidate Pipeline Summary
@Workable get a summary of all candidates grouped by stage — I need to see how many are in screening, interview, offer, and hired.Open in a Space →
Create New Department
@Workable create a department called 'Customer Success - EMEA' with description 'European customer success team reporting to VP of CS'.Open in a Space →
Check Background Providers
@Workable show me all background check providers we have integrated, along with their available packages.Open in a Space →
Reactivate Team Member
@Workable enable the member account for jane.doe@company.com — she's rejoining the recruiting team and needs access restored.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@workable show me all candidates who applied in the last 7 days and group them by job title
Retrieved 23 candidates from the past week across 5 active job postings. The breakdown: Senior Backend Engineer (9 candidates), Product Designer (6), DevOps Engineer (4), Frontend Developer (3), Engineering Manager (1). Most applications came through your careers page (17), with 4 from LinkedIn and 2 from referrals. All candidates are currently in the 'Applied' stage awaiting initial review.
This example demonstrates the Get Candidates tool paired with AI filtering and grouping. Requires OAuth2 scope for reading candidate data. Note that Workable's API returns candidates across all jobs you have access to—large organizations may hit pagination limits or need to narrow the query by specific job IDs.
@workable create a new department called 'Machine Learning' under the Engineering division
Created department 'Machine Learning' successfully. The new department ID is dept_8x3k9m and it's now available for assignment when posting jobs or organizing team members. You can view it in your Workable account under Settings > Departments. No members are currently assigned—you'll need to move or invite team members separately.
This showcases the Create Department tool for organizational structure changes. Requires write permissions via OAuth2. Be aware this is a live action—the department persists in your Workable account immediately. If you're testing, you may want to delete it afterward using the Delete Department tool to avoid clutter.
@workable pull the account details for our main hiring workspace and summarize our current background check integrations
Your Workable account 'acme-corp' (subdomain: acme-corp.workable.com) is on the Premier plan with 12 active recruiters and 47 open job postings. For background checks, you have two providers integrated: Checkr (3 packages available: Basic, Standard, Professional) and Sterling (2 packages: Essentials, Comprehensive). Checkr is set as your default provider. Both integrations are active and ready to initiate checks directly from candidate profiles.
This example chains Get Account, Get Background Check Providers, and Get Background Check Packages to give a holistic view of account setup. Demonstrates how the MCP can surface configuration details that aren't always visible in the UI. Useful for onboarding new recruiters or auditing compliance tooling before a hiring sprint.
Use-case deep-dives
When Workable MCP streamlines new-hire department setup
A 12-person remote startup hiring across three time zones uses Workable MCP to auto-create departments and enable member accounts as candidates convert to hires. The MCP's Create Department and Enable Member tools let a Slack workflow trigger department setup the moment an offer is accepted, eliminating the two-day lag between HR's manual entry and IT provisioning. This works cleanly when your hiring velocity is under 15 people per quarter—above that threshold, you'll want a dedicated HRIS integration instead of scripting through the MCP's 21 tools. If your team closes 2-4 hires a month and already runs Workable, this MCP cuts onboarding setup time from hours to seconds without adding another SaaS contract.
Pull hiring metrics without exporting CSVs every week
A Series A company's CFO needs weekly candidate funnel data for board decks but doesn't want recruiting ops manually exporting Workable reports. The Get Candidates tool aggregates all applicants across jobs in one call, letting a scheduled agent pull counts by stage and department every Monday morning. This scenario wins when you have 5-20 open roles and need consistent snapshots—if you're running 50+ concurrent searches, Workable's native analytics dashboard is faster than parsing API responses. The OAuth2 setup takes 10 minutes; after that, your finance team gets live hiring data in their existing reporting stack without pestering recruiters for spreadsheets.
When you're evaluating screening providers mid-growth
A 30-person SaaS company scaling to 60 employees needs to compare background check packages across three vendors Workable integrates with. The Get Background Check Providers and Get Background Check Packages tools surface pricing and turnaround times without opening five browser tabs or scheduling vendor demos. This is the right call when you're making a one-time vendor decision or auditing your current provider's rates—if you run checks daily at scale, you'll negotiate direct contracts instead of using Workable's passthrough. For teams hiring 3-8 people per quarter who want to validate they're not overpaying for screening, this MCP answers the question in under an hour.
Frequently asked
What does the Workable MCP do in Switchy?
The Workable MCP connects your applicant tracking system to Switchy's AI workspace. Your team can query candidate pipelines, create departments, manage member access, and pull background check data without switching to the Workable web app. It exposes 21 tools covering account management, candidate retrieval, department operations, and member activation—useful for recruiting ops teams who need to automate hiring workflows or build custom reporting on top of Workable's data.
Do I need admin access to connect Workable via OAuth?
Yes. The OAuth2 flow requires permissions to read accounts, manage departments, and modify member status—actions typically restricted to Workable admins or account owners. If you're a hiring manager with read-only access, you won't be able to complete the connection. Check your Workable role under Settings > Users before attempting to authenticate. Switchy will surface an error if your token lacks the necessary scopes during the handshake.
Can the Workable MCP post jobs or send candidate emails?
No. The 21 tools focus on reading candidate data, managing departments, and toggling member status—not publishing jobs or sending outbound messages. If you need to post a new role or email a candidate, you'll still use Workable's UI or their separate Jobs API. The MCP is designed for operational queries and org structure changes, not end-to-end recruiting workflows. Think of it as a read-heavy integration with selective write access to departments and members.
How does this compare to calling Workable's REST API directly?
The MCP abstracts away token refresh, pagination, and error handling—your prompts in Switchy trigger the right sequence of API calls without writing code. If you're already running custom scripts against Workable's API, the MCP won't add much. But for teams who want to ask "show me all candidates in the engineering pipeline" without maintaining a Python notebook, the MCP is faster. You trade flexibility for convenience and natural-language access.
Who on the team should connect the Workable MCP?
Your recruiting ops lead or HR admin—whoever owns Workable configuration and has admin credentials. Once connected, any Switchy workspace member can invoke the tools, but the OAuth token belongs to the person who authenticated. If that person leaves or loses Workable access, the connection breaks. Plan to rotate the token ownership to a shared service account if your org allows it, or document who holds the credential in your team wiki.