Workday MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Workday MCP or direct API to fetch employee data, manage time-off requests, automate approvals, and generate reports through natural language.

Workday logoWorkday
Oauth2

Workday is a cloud-based ERP platform for HR, finance, and workforce analytics. It streamlines employee management, payroll, and business operations in a single system.

84 Tools13 Triggers

Try Workday now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Workday
Try asking
TOOLS & TRIGGERS

Supported Tools and Triggers

Every Workday action and event your agent gets out of the box.

Create Business Title Change

Creates a business title change instance for a worker with the specified data.

Create Job Change

Tool to create a job change instance for a worker in Workday.

Create Payroll Inputs

Tool to create payroll inputs in Workday.

Create Time Off Request

Creates a time off request for the specified worker and initiates the business process.

Get Absence Balance

Retrieves balance information for a specific worker's absence plan.

Get Assignment Change Group Cost Centers

Retrieves cost center instances for organization assignment changes.

Get Assignment Change Group Jobs

Retrieves job instances for organization assignment changes.

Get Assignment Types

Retrieves assignment type values for job changes in Workday.

Get Business Title Change

Retrieves a business title change instance by ID.

Get Business Title Change For Worker

Tool to retrieve a business title change instance for a specific worker.

Get Candidate Availability Template

Tool to retrieve the candidate availability template version for a specific job posting.

Get Collection of Jobs

Tool to retrieve a paginated collection of jobs from Workday Staffing system.

Get Collection of Payroll

Tool to retrieve a collection of payroll inputs from Workday.

Get Company Insider Types

Retrieves company insider types from Workday Staffing API.

Get Contingent Worker Types

Tool to retrieve contingent worker types from Workday staffing API.

Get Country Info

Retrieves detailed information about a specific country from Workday.

Get Currencies

Retrieves currency instances for job changes in Workday.

Get Current User

Retrieves the current authenticated worker's profile information from Workday.

Get Grants

Retrieves grant instances for organization assignment changes.

Get Headcount Options

Retrieves headcount option instances that can be used as values for other endpoint parameters.

Get History Instance for Worker

Tool to retrieve a specific history instance for a worker.

Get History Items for Worker

Tool to retrieve a collection of history items for a specific worker.

Get Holiday Events

Returns the holiday events for the specified workers and time period.

Get Interview

Tool to retrieve detailed information about a specific interview from Workday Recruiting.

Get Interview Feedback

Retrieves interview feedback for the specified interview ID from Workday Recruiting API.

Get Job By ID

Tool to retrieve detailed information about a single job instance by its ID.

Get Job Change Frequencies

Retrieves frequency instances for job changes in Workday.

Get Job Change Location Info

Tool to retrieve location information for a specific job change in Workday.

Get Job Change Position

Retrieves position details for a specific job change in Workday Staffing API.

Get Job Change Reason Instance

Retrieves a job change reason instance from Workday.

Get Job Change Reasons

Retrieves a collection of job change reasons from Workday.

Get Job Change Reason Values

Retrieves job change reason instances that can be used as values for other staffing endpoint parameters.

Get Job Changes Group Templates

Retrieves job changes group template instances in Workday.

Get Job Changes Job Values

Retrieves job instances that can be used as values for job changes parameters.

Get Job Changes Worker Values

Retrieves worker instances that can be used as values for job changes parameters.

Get Job Classifications

Retrieves job classification instances for job changes in Workday.

Get Job Posting

Retrieves detailed information about a specific job posting including job description.

Get Job Posting Questionnaire

Retrieves screening questions and questionnaires associated with a specific job posting.

Get Job Profiles Values

Retrieves job profile instances from Workday Staffing API.

Get Job Requisition Values

Retrieves job requisition instances that can be used as values for other endpoint parameters.

Get Job Workspace

Tool to retrieve a single workspace instance for a specific job.

Get Job Workspaces

Tool to retrieve a collection of workspaces for a specified job ID.

Get Leave Status Values

Get all available leave status values from Workday.

Get My Job Postings

Retrieves job postings assigned to the authenticated user (current recruiter).

Get Organization Assignment Business Units

Retrieves business unit instances for organization assignment changes.

Get Organization Assignment Customs

Retrieves custom organization assignment instances.

Get Organization Assignment Funds

Retrieves fund instances for organization assignment changes.

Get Organization Assignment Regions

Retrieves region instances for organization assignment changes.

Get Organization Assignment Workers

Retrieves worker instances for organization assignment changes.

Get Pay Group by Job ID

Retrieves the pay group for a specified job ID.

Get Payroll Input Instance

Retrieves detailed information for a single payroll input instance by ID.

Get Pay Slip Instance for Worker

Retrieves a specific pay slip instance for a worker.

Get Pay Slips for Worker

Retrieves a collection of pay slips for a specific worker.

Get Proposed Position Values

Retrieves proposed position instances that can be used as values for job changes parameters.

Get Prospect

Retrieves a single prospect instance for talent matching and best-fit analysis.

Get Prospect Educations

Retrieves the educational background of a prospect from Workday Recruiting API for talent matching and best-fit analysis.

Get Prospect Experiences

Retrieves the work experience of a prospect for talent matching and best-fit analysis.

Get Prospect Resume Attachments

Retrieves resume attachments for a specific prospect to help prepare for upcoming interviews.

Get Prospect Skills

Retrieves the skills of a prospect from Workday Recruiting API for talent matching and best-fit analysis.

Get Supervisory Organization Values

Retrieves supervisory organization instances that can be used as values for job changes parameters.

Get Time Off Entries for Worker

Retrieves a collection of time off entries for a specific worker.

Get Time Off Plans For Worker

Retrieves a collection of time off plans for a specific worker.

Get Time Off Status Values

Retrieves available time off status values from Workday.

Get Time Types

Retrieves time type values for job changes in Workday.

Get Worker Business Title Changes

Retrieves business title changes for a specific worker.

Get Worker Eligible Absence Types

Retrieves a collection of eligible absence types for the specified worker.

Get Worker Info

Retrieves detailed worker information including staffing data.

Get Worker Leaves of Absence

Retrieves the Leaves Of Absence for the specified worker using the working absenceManagement v1 API.

Get Workers Collection Staffing

Tool to retrieve workers and current staffing information from Workday.

Get Worker Service Dates

Tool to retrieve service dates for a specified worker from Workday Staffing API v6.

Get Worker Staffing Information

Tool to retrieve a worker's current staffing information from Workday.

Get Worker Time Off Details

Retrieves a collection of time off details for the specified worker.

Get Worker Types

Retrieves worker type instances that can be used as values for job changes parameters.

Get Worker Valid Time Off Dates

Retrieves valid time off dates for a worker, indicating when they are eligible to take time off.

Get Workspace Instances

Tool to retrieve workspace instances that can be used as prompt values for other Workday API parameters.

Get Work Study Awards

Retrieves work study award instances for job changes in Workday.

List Countries

Retrieves country values from Workday Recruiting API.

List Interviews

Retrieves a list of interviews with job requisition and recruiter assignment details.

List Job Postings

Retrieves a paginated list of job postings from Workday Recruiting system.

List Jobs

Retrieves a collection of jobs from Workday Staffing system.

Retrieve Worker Leave of Absence

Retrieves the leave of absence details for a specified worker.

Update An Existing Payroll

Tool to partially update an existing payroll input instance in Workday.

Update Job Change Business Title

Partially updates the business title for a specific job change.

Update Message Template By ID

Tool to update a message template in Workday by its ID.

SETUP GUIDE

Connect Workday MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["workday"],
  mcp: true,
});
Create a session scoped to Workday and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Submit vacation request for next Friday",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Workday request
SETUP GUIDE

Connect Workday API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["workday"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Workday
3

Run Workday tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Submit vacation request for next Friday" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Workday tool calls through the session, and print the final answer

Why Use Composio?

AI Native Workday Integration

  • Supports both Workday MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Workday data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Workday access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Workday
  • Scoped, least privilege access to Workday resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Workday requires connections to go through your own OAuth app. You register it once with Workday, add its client ID and secret in the Composio dashboard, and from then on everyone connects by signing in to Workday as usual. Composio handles the rest of the flow and the token refresh.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Workday connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

When you connect a Workday account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Workday as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Exactly the ones Workday lists on its consent screen when you connect. Review that screen before approving. If you connect a work account, your Workday administrator may need to approve the app first, and you can revoke the access inside Workday whenever you want.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Workday connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

Composio refreshes Workday tokens automatically, so day to day you do nothing. If you revoke access inside Workday, or Workday invalidates the session, the connection shows as expired in Composio and the agent stops acting on that account until you reconnect it, which is a single sign-in.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Workday use. Paid plans add higher limits and team features. Your Workday plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Workday accounts).

With Composio, you connect Workday once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Workday.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Workday tool your agent needs.Free to start.

Start building