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
Setup
- •Add the Rube MCP server to your Claude Code config with URL:
https://rube.app/mcp - •When prompted, authenticate your Workday account through the connection link provided
- •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 includeactionwithidfield (use"d9e4223e446c11de98360015c5e6daf6"for submit action) - •
days(required) -- array of time off entries, each with:- •
date(required) -- date inyyyy-mm-ddformat - •
timeOffType(required) -- object withidof 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
Known Pitfalls
- •Worker ID resolution: Always call
WORKDAY_GET_CURRENT_USERorWORKDAY_LIST_WORKERSfirst to resolve Workday worker IDs. Worker IDs are Workday-specific UUIDs, not employee numbers. - •Time off type IDs must be valid: The
timeOffType.idinWORKDAY_CREATE_TIME_OFF_REQUESTmust 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.idshould 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-ddformat. ISO 8601 with timestamps is not accepted for date-only fields. - •Pagination limits: The maximum
limitis 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.
Quick Reference
| Tool Slug | Description |
|---|---|
WORKDAY_LIST_WORKERS | Search and list workers with staffing info |
WORKDAY_GET_CURRENT_USER | Get the authenticated worker's profile |
WORKDAY_CREATE_TIME_OFF_REQUEST | Submit a time off request (requires ID, businessProcessParameters, days) |
WORKDAY_GET_WORKER_VALID_TIME_OFF_DATES | Check time off date eligibility (requires ID) |
WORKDAY_LIST_ABSENCE_BALANCES | Retrieve absence balances across time off plans |
WORKDAY_GET_WORKER_TIME_OFF_DETAILS | Get time off history for a w |