request_time_off
Request Time Off
Submit a time-off request for a specific worker. Initiates a Request Time Off business process for one day with the specified type and quantity. Approval or later business-process steps may remain pending.
Ask your agent in plain language. Each of these maps to a real tool on the server.
request_time_off
Submit a time-off request for a specific worker. Initiates a Request Time Off business process for one day with the specified type and quantity. Approval or later business-process steps may remain pending.
update_custom_object
Update an existing custom object record in Workday. The documented PUT accepts the fields to update. Worker binding and custom reference identity cannot be changed; the result is read back before success is returned.
list_organizations
Retrieve a list of supervisory organizations in Workday. Supervisory organizations represent the management hierarchy and team structure.
list_custom_objects
List worker-scoped multi-instance records of a tenant-defined custom object type. Pagination slices a verified complete native collection locally. Custom objects extend Workday's data model for organization-specific needs.
get_custom_object
Retrieve a specific custom object record by its type and ID. Returns all fields of the custom object record.
create_custom_object
Create a new custom object record in Workday. The record fields depend on the custom object definition configured in your tenant. Include the extended worker in fields.worker and a custom reference ID. Supply its exact compound objectId for readback; types without reference IDs cannot be created safely through this tool.
get_custom_report
Retrieve data from a Workday custom report via Report-as-a-Service (RaaS). Reports must be Advanced type and web-service enabled in Workday. Supports passing prompt parameters to filter report data.
get_time_off_entries
Retrieve time-off entries for a specific worker. Returns requested time-off entries with details including dates, quantities, types, and statuses. Optionally filter by date range.
get_inbox_tasks
Retrieve pending inbox tasks for a specific worker. Returns business process steps awaiting action, such as approvals, reviews, and to-do items.
action_inbox_task
Approve or deny a pending inbox task for a worker. Only an Approval step awaiting action for the connected worker is supported. Discover that worker with get_current_user and read the task first; subsequent business-process steps may remain pending.
get_time_blocks
Retrieve time tracking blocks for a specific worker. Returns recorded time entries including clock-in/out times and durations. Optionally filter by date range.
execute_wql
Execute a Workday Query Language (WQL) query against Workday data. WQL is a SQL-like language for high-performance querying of Workday data across functional areas. Supports **SELECT**, **FROM**, **WHERE**, **LIMIT**, and **OFFSET** clauses.
get_organization_workers
Retrieve the list of workers within a specific supervisory organization. Useful for finding all team members under a given manager or department.
list_workers
Search and list workers in Workday. Returns a paginated list of worker summaries including names, emails, titles, and organization assignments. Use **search** for a name prefix of at least three consecutive characters.
delete_custom_object
Delete a custom object record from Workday. This action is irreversible.
get_worker
Retrieve detailed information about a specific worker by their ID. Returns the authorized Common worker profile. Available fields depend on security permissions; compensation and employment status are not guaranteed by this API.
get_resource
Read an exact supervisory organization, inbox task, time-off detail, or recorded time block. Discover IDs with list_organizations, get_inbox_tasks, get_time_off_entries or get_time_blocks.
get_current_user
Discover the worker bound to the connected Workday account. Returns only the worker ID and display name. Integration system users and other service accounts may not have a worker identity.
list_resources
Discover prerequisites for existing Workday actions: eligible absence types and valid time-off dates, or WQL data sources and fields. IDs and units depend on the connected account and worker.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Read authorized Workday workers, supervisory organizations, absence details, recorded time blocks and inbox tasks. Discover the connected worker and prerequisites for time-off requests and WQL queries. Request time off or act on an eligible connected-worker approval, run enabled custom reports, and manage worker-bound multi-instance custom objects. Access and available actions depend on tenant security policies.
Common questions about connecting Workday to AI agents with Metorial.