Workable MCP Server

Create a new sourced candidate and attach them to a specific job identified by its shortcode. The shortcode is required — use get_jobs to find the job shortcode if unknown. At minimum provide email plus either name or firstname+lastname.

create_candidate

Add a candidate to the talent pool when there is no specific job to match them to but they are a good prospect for future opportunities. Unlike create_candidate, no job shortcode is needed — the candidate is stored in the talent pool and can be matched to a job later. Supports the same fields as create_candidate except answers.

create_talent_pool_candidate

Create a new department.

create_department

Create a new performance review cycle template with sections and questions. All body fields (template title, section body, question body) must be non-empty strings — the API rejects empty values, so use a label like "Section rating" / "Overall rating" for rating questions rather than an empty string. Valid question types: "paragraph" (long text), "star_rated" (1-5 stars), "custom_rated" (labeled scale via metadata.ratingOptions), "numeric_rated" (numeric score), "multiple_choice" (options via metadata.answerOptions.choices). To mark a question as the section-level or template-level rating, set metadata.semanticType to "section_rating" (one per section, must be a rated type) or "overall_rating" (one per template, must be a rated type).

create_review_cycle_template

Create a new requisition

create_requisition

Create a complete time entry (clock-in and clock-out) for an employee in a single call. Use clock_in / clock_out for open-ended shifts

create_time_entry

Delete a department by its ID. Use force to delete even if the department has associated data.

delete_department

Remove (deactivate) a member from the account, revoking their access — used for offboarding workflows. This is a reversible deactivation, not a hard delete: the member can be reinstated later with enable_member. On success returns a confirmation (the endpoint returns 204 with no body). An error is returned if the member ID does not exist (404) or the member cannot be removed due to account restrictions, e.g. they are the sole admin (422).

delete_member

Disqualify a candidate from a job. Use this tool with candidate IDs obtained from get_candidates or get_candidates_by_job_name tools. IMPORTANT: Before calling this tool, use get_disqualification_reasons to retrieve the available disqualification reason IDs for the account.

disqualify_candidate

Re-enable (restore) a previously deactivated member, reinstating their access. This action is idempotent: enabling an already-active member succeeds as a no-op (it is not an error). On success returns a confirmation (the endpoint returns no body, and enablement may propagate asynchronously, so the member is not fetched afterwards — use get_members to read the refreshed state). An error is returned if the member ID does not exist (404) or the member could not be restored (422).

enable_member

Fetch a single review by its id (the template merged with any persisted answers — i.e. the autosaved draft). Returns { review, questionnaire }. Use this to load a review before writing, or to resume filling one in after a previous save. The caller must be the assigned reviewer of the review (the reviewee for self-reviews). Discover review ids from active_tasks[].reviews[].id via list_review_tasks.

get_review

Get all custom attributes configured for the account

get_account_custom_attributes

Get all Workable accounts accessible to the authenticated user. Call this first to discover the available accounts before invoking any other tool, and use the returned subdomain as the account parameter.

get_accounts

Fetch the full review aggregate for an employee within a cycle, including aggregate status/state, the reviewee, the manager, the cycle, and every review visible to the caller (each as { review, questionnaire }). Peer / upward reviewers only see their own assigned review. Use the reviewee employee id (e.g. from active_tasks[].reviewee.id or an active_tasks[].actions.view URL).

get_review_aggregate

Get activities for a specific candidate by ID. Returns a list of actions taken on the candidate such as stage changes, comments, and other events.

get_candidate_activities

Get details for a specific activity on a candidate.

get_candidate_activity

Returns all available candidate fields with their types and search capabilities. Fields with search_field can be used as filters in search_candidates_detailed. When filter_type is "dropdown", use get_candidate_detailed_filter_options to fetch the allowed values.

get_candidate_detailed_fields

Get detailed information for a specific candidate by ID. Use this tool with candidate IDs obtained from get_candidates or get_candidates_by_job_name tools.

get_candidate

Returns the available values for a dropdown candidate filter field. Pass the search_field value from get_candidate_detailed_fields as filter_id.

get_candidate_detailed_filter_options

Get the offer for a specific candidate by ID

get_candidate_offer

Get all available disqualification reasons in your Workable account

get_disqualification_reasons

Get details for a specific employee by ID

get_employee

Returns the available values for a dropdown employee filter field. Pass the search_field value from get_employee_fields as filter_id.

get_employee_filter_options

Returns all available employee fields with their types and search capabilities. Fields with search_field can be used as filters in search_employees. When filter_type is "dropdown", use get_employee_filter_options to fetch the allowed values.

get_employee_fields

Get detailed information for a specific event by its ID. Use this tool when the user requests details about a specific event from the get_events results. The event ID should be obtained from the get_events tool response.

get_event

Get events from your Workable account with optional filtering. Returns a numbered list of events with their IDs for easy reference. After showing the results, ask the user if they would like to get detailed information about any specific event, then use the get_event tool with the event ID.

get_events

Get activities for a specific job

get_job_activities

Get application form for a specific job

get_job_application_form

Get details for a specific job by shortcode

get_job

Get custom attributes for a specific job

get_job_custom_attributes

Get members for a specific job

get_job_members

Get external recruiters for a specific job

get_job_recruiters

Get stages for a specific job

get_job_stages

Returns up to 10 jobs by default. By default only published jobs are returned; closed, draft, and archived jobs are excluded. If you are looking for a specific job or its candidates and find nothing, retry with state: 'closed', 'archived', or 'draft' before concluding the job does not exist. If more jobs are available, the response will include a since_id value you can use to fetch the next page.

get_jobs

Get all legal entities in your Workable account

get_legal_entities

Get details for a specific offer by its ID

get_offer

Get the organization chart for employees in your Workable account

get_orgchart

Get a specific performance review cycle by ID, including dates, deadlines, counts and which review types are configured.

get_review_cycle

Get a specific performance review cycle template by ID, including its sections and questions

get_review_cycle_template

Get all available recruitment pipeline stages in your Workable account

get_stages