The Workable MCP server provides full programmatic access to the Workable recruiting and HR platform. It covers the entire hiring lifecycle — from job management and candidate sourcing through offer approvals — as well as HR operations like employee management and time off.

How to Use

Server URL: https://mcp.workable.com/mcp
Transport: Streamable HTTP, stateless, JSON mode. No SSE, no streaming.
Authentication: The server uses OAuth2 authentication
Account selection: Every tool except get_accounts requires an account parameter. Call get_accounts first to list the Workable accounts available to the authenticated user, then pass the chosen account's subdomain as the account value on every subsequent tool call.

Dynamic discovery

The server supports OAuth dynamic discovery and Dynamic Client Registration (RFC 7591 / RFC 8414), so compatible clients can register and configure themselves automatically without manual credential setup. The following well-known metadata endpoints are available:

GET https://mcp.workable.com/.well-known/oauth-authorization-server
GET https://mcp.workable.com/.well-known/oauth-protected-resource

Table of Contents

Accounts
Jobs
Candidates
Offers
Requisitions
Pipeline & Account Config
Employees
Departments
Legal Entities
Work Schedules
Events
Time Off
Time Tracking
Performance Reviews
What This MCP Server Enables

Accounts (1 tool)

Tool	Description
`get_accounts`	List all Workable accounts accessible to the authenticated user. Call this first — use the returned `subdomain` as the `account` parameter on every other tool

Jobs (8 tools)

Tool	Description
`get_jobs`	List jobs filtered by state (`published`, `draft`, `archived`, `closed`)
`get_job`	Get full details for a specific job by shortcode
`get_job_activities`	Get the activity log for a specific job
`get_job_application_form`	Get the application form questions for a job
`get_job_custom_attributes`	Get custom attributes configured for a job
`get_job_members`	Get team members assigned to a job
`get_job_recruiters`	Get external recruiters assigned to a job
`get_job_stages`	Get the pipeline stages configured for a job

Candidates (12 tools)

Tool	Description
`get_candidates`	List candidates for a job with filtering by stage, email, and date
`get_candidate`	Get full profile details for a specific candidate
`get_candidate_activities`	Get the activity log for a candidate (stage changes, comments, etc.)
`get_candidate_activity`	Get details for a single candidate activity
`get_candidate_offer`	Get the offer associated with a specific candidate
`create_candidate`	Source a new candidate and attach them to a specific job (supports resume, social profiles, education, experience, and application answers)
`create_talent_pool_candidate`	Add a candidate to the talent pool without attaching to a specific job
`move_candidate`	Move a candidate to a different pipeline stage (supports requisition linking on hire)
`disqualify_candidate`	Disqualify a candidate with a reason (rejected or withdrew)
`add_comment`	Add a comment to a candidate with visibility controls
`add_review`	Add a rating/review to a candidate (thumbs, stars, or numeric scale)
`update_candidate_tags`	Replace the full set of tags on a candidate — the provided array overwrites all existing tags (pass `[]` to clear). To add a tag while keeping existing ones, fetch the candidate first and merge

Offers (3 tools)

Tool	Description
`get_offer`	Get details for a specific offer by ID
`approve_offer`	Approve an offer
`reject_offer`	Reject an offer with an optional rejection reason

Requisitions (5 tools)

Tool	Description
`get_requisitions`	List requisitions with filtering by state, job, and date
`get_requisition`	Get details for a specific requisition by code
`create_requisition`	Create a new headcount requisition with job title, owner, hiring manager, salary, and department
`approve_requisition`	Approve a requisition by code
`reject_requisition`	Reject a requisition with an optional rejection reason

Pipeline & Account Config (4 tools)

Tool	Description
`get_stages`	Get all available recruitment pipeline stages in the account
`get_members`	List account members, filterable by role, status, email, and job
`get_disqualification_reasons`	Get all configured disqualification reasons (required before disqualifying a candidate)
`get_account_custom_attributes`	Get all custom attributes configured at the account level

Employees (3 tools)

Tool	Description
`get_employees`	List employees with search, status filtering, and ordering by department or division
`get_employee`	Get full details for a specific employee
`get_orgchart`	Get the organization chart, optionally scoped to a legal entity, department, or employee subtree

Departments (5 tools)

Tool	Description
`get_departments`	List all departments in the account
`create_department`	Create a new department, optionally under a parent department
`update_department`	Update a department's name or parent
`delete_department`	Delete a department by id (supports `force` to delete even when the department has data)
`merge_department`	Merge a source department into a target department, moving all associated data

Legal Entities (1 tool)

Tool	Description
`get_legal_entities`	Get all legal entities configured in the account

Work Schedules (1 tool)

Tool	Description
`get_work_schedules`	Get all work schedules configured in the account

Events (2 tools)

Tool	Description
`get_events`	List events (calls, interviews, meetings) with filtering by job, candidate, member, type, and date range
`get_event`	Get full details for a specific event

Time Off (5 tools)

Tool	Description
`get_timeoff_requests`	Get time off requests within a date range, filterable by employee, category, and state
`get_timeoff_balances`	Get time off balances for a specific employee or all employees
`get_timeoff_categories`	Get all configured time off categories
`create_timeoff_request`	Create a new time off request (supports half-day entries and notes)
`update_timeoff_approval`	Approve or reject a pending approval from the `pending_approvals` array

Time Tracking (6 tools)

Tool	Description
`list_time_entries`	List time tracking entries with filters for date range, employees, type (`time-entry`, `clock-in`, `clock-out`), and duration
`create_time_entry`	Create a complete time entry (both `clock_in_time` and `clock_out_time`) for an employee
`clock_in`	Open a clock-in for an employee at the supplied UTC timestamp (`clock_in_time` is required)
`clock_out`	Close the currently open clock-in for an employee at the supplied UTC timestamp (`clock_out_time` is required); returns an array of the entries closed by this clock-out
`bulk_create_time_entries`	Create complete time entries for multiple employees in one request (max 500)
`update_time_entry`	Update an existing entry's clock-in/out times or note (pass `note: null` to clear)

📘
Time strings on time-tracking responses are ISO 8601 in UTC (with the Z suffix). Each entry includes a timezone field with the IANA timezone resolved for the timesheet — use it to render wall-clock time when needed. See the time-tracking API docs for details.

Performance Reviews (3 tools)

Tool	Description
`get_review_cycle_templates`	List performance review cycle templates (paginated)
`get_review_cycle_template`	Get a specific template by id, including its sections and questions
`create_review_cycle_template`	Create a template with sections and questions (paragraph, star / numeric / custom rated, multiple choice). Mark a question as the section-level or template-level rating by setting `metadata.semanticType` to `"section_rating"` (one per section, must be a rated type) or `"overall_rating"` (one per template, must be a rated type)

What This MCP Server Enables

The Workable MCP server bridges AI assistants directly with the Workable platform, enabling:

End-to-end recruiting automation — search jobs, source candidates, move them through the pipeline, add reviews, and manage offers without leaving your AI interface
HR self-service — look up employees, explore the org chart, check time off balances, and create or approve leave requests conversationally
Org structure management — maintain departments and legal entities, and consult work schedules when onboarding
Time tracking operations — list, create, bulk-create, and update time entries for employees
Performance management — manage performance review cycle templates used to run review cycles
Requisition workflows — create, approve, or reject headcount requests programmatically
Multi-account support — operate across multiple Workable accounts from a single integration
Audit & reporting — retrieve activity logs for both jobs and candidates to understand hiring progress