Workday Automation

Automate your Workday HR operations directly from Claude Code. Look up workers, create time off requests, check absence balances, and validate time off eligibility -- all without leaving your terminal.

Toolkit docs: composio.dev/toolkits/workday

设置

1. Add the Rube MCP server to your Claude Code config with URL:

   https://rube.app/mcp

2. When prompted, authenticate your Workday account through the connection link provided
3. Start automating your HR workflows with natural language

Core Workflows

1. Search and List Workers

Retrieve worker information with search and pagination.

Tool:

WORKDAY_LIST_WORKERS

Search for workers named "Sarah" and include terminated employees

Key parameters:

• search

  -- search by name or worker ID (case-insensitive, space-delimited for OR search)

• includeTerminatedWorkers

  -- include terminated workers in results

• limit

  (default 20, max 100) /

  offset

  -- pagination controls

2. Create Time Off Requests

Submit time off requests for workers with full business process support.

Tool:

WORKDAY_CREATE_TIME_OFF_REQUEST

Create a vacation request for worker abc123 for March 15-17, 2026 (8 hours each day)

Key parameters:

• ID

  (required) -- Workday worker ID

• businessProcessParameters

  (required) -- must include

  action

  with

  id

  field (use

  "d9e4223e446c11de98360015c5e6daf6"

  for submit action)

• days

  (required) -- array of time off entries, each with:

  • date

    (required) -- date in

    yyyy-mm-dd

    format

  • timeOffType

    (required) -- object with

    id

    of the eligible absence type

  • dailyQuantity

    -- hours or days quantity

  • comment

    ,

    start

    ,

    end

    ,

    position

    ,

    reason

    -- optional fields

• businessProcessParameters.comment

  -- optional business process comment

3. Check Time Off Eligibility

Validate which dates a worker can take off before submitting a request.

Tool:

WORKDAY_GET_WORKER_VALID_TIME_OFF_DATES

Check if worker abc123 is eligible to take time off on March 15, 2026

Key parameters:

• ID

  (required) -- Workday worker ID

• date

  -- specific date to validate (

  yyyy-mm-dd

  )

• position

  -- filter by specific position ID

• timeOff

  -- filter by specific time off plan/type ID

• limit

  (max 100) /

  offset

  -- pagination

4. View Absence Balances

Check remaining time off balances for workers across all plans.

Tool:

WORKDAY_LIST_ABSENCE_BALANCES

Show me absence balances for all workers in the organization

• Retrieves balances for time off plans and leave of absence types
• Can be filtered by worker ID, category, and effective date

5. Get Current User Profile

Retrieve the authenticated worker's profile information.

Tool:

WORKDAY_GET_CURRENT_USER

Show me my Workday profile information

• No parameters required
• Returns the authenticated worker's profile
• Use this first to get the worker ID for subsequent operations

6. View Time Off History

Retrieve time off details and history for a specific worker.

Tool:

WORKDAY_GET_WORKER_TIME_OFF_DETAILS

Show me the time off history for worker abc123

• Retrieves a collection of time off details for the specified worker
• Useful for auditing time off usage and remaining balances

已知陷阱

• Worker ID resolution: Always call

  WORKDAY_GET_CURRENT_USER

  or

  WORKDAY_LIST_WORKERS

  first to resolve Workday worker IDs. Worker IDs are Workday-specific UUIDs, not employee numbers.
• Time off type IDs must be valid: The

  timeOffType.id

  in

  WORKDAY_CREATE_TIME_OFF_REQUEST

  must reference a valid eligible absence type for that worker. Use the "Get Worker Eligible Absence Types" flow to discover valid type IDs.
• Submit action ID: The

  businessProcessParameters.action.id

  should be

  "d9e4223e446c11de98360015c5e6daf6"

  for the submit action. Using an incorrect ID will cause the business process to fail.
• Date format: All date fields use

  yyyy-mm-dd

  format. ISO 8601 with timestamps is not accepted for date-only fields.
• Pagination limits: The maximum

  limit

  is 100 across all Workday endpoints. Default is 20. Always paginate for complete datasets.
• Business process approval: Creating a time off request initiates the business process but does not guarantee approval. The request enters the normal approval workflow.

快速参考

WORKDAY_LIST_WORKERS

WORKDAY_GET_CURRENT_USER

WORKDAY_CREATE_TIME_OFF_REQUEST

ID

businessProcessParameters

days

WORKDAY_GET_WORKER_VALID_TIME_OFF_DATES

ID

WORKDAY_LIST_ABSENCE_BALANCES

WORKDAY_GET_WORKER_TIME_OFF_DETAILS

由 Composio 提供支持