Workday MCP for AI Agents

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/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

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

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

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

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Get absence balance for employee ID 12345' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Workday API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

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

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Workday Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Submit vacation request for next Friday'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Workday actions with your Agent

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
FAQ

Frequently asked questions

Yes, Workday requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

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

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

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

Start with Workday.It takes 30 seconds.

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

Start building