Workday Automation

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

1. Add the Composio MCP server to your Claude Code config with URL: http://localhost:8787/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

Known Pitfalls

• 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.

Quick Reference

Powered by Composio