Workday — Claude Code MCP server: what it does, how to install
Connects Workday HCM to LLM clients to query worker profiles, direct reports, org structures, time off, and requisitions.
claude mcp add mcp-server-workday -e WORKDAY_HOST=<WORKDAY_HOST> -e WORKDAY_TENANT=<WORKDAY_TENANT> -e WORKDAY_CLIENT_ID=<WORKDAY_CLIENT_ID> -e WORKDAY_CLIENT_SECRET=<WORKDAY_CLIENT_SECRET> -e WORKDAY_REFRESH_TOKEN=<WORKDAY_REFRESH_TOKEN> -- npx -y @mindstone/mcp-server-workdayWhat Workday does
This connector gives the model nine tools to query Workday HCM endpoints over OAuth 2.0. It retrieves worker profiles, organizational units, office sites, and job assignments. Returned string values are enclosed in untrusted-content wrappers so external text cannot inject instructions into the host session.
Worker lookups rely on client-side scanning capped at 1000 entries because the upstream API lacks deep search filters. Broad queries on large tenants will miss matches. Accessing absence history and job requisitions also demands explicit ISU permissions for the Absence Management and Recruiting domains. When requisition requests fail with 404 responses, the version needs adjusting via WORKDAY_RECRUITING_API_VERSION.
Running the package requires Node.js 20 or newer alongside OAuth client credentials. Parameters can be set via shell variables or through the configure_workday_credentials tool directly inside the chat.
What it helps with
- inspect worker profiles and organizational reporting chains
- retrieve approved and pending employee time-off entries
- audit open job requisitions across recruiting domains
- browse company departments, cost centers, and site locations
Example prompts for the agent
- Retrieve the worker profile and reporting hierarchy for employee ID 4091.
- Check upcoming absence records for [email protected].
- List active engineering job requisitions across all company locations.
How to install Workday
Platform CLI
claude mcp add mcp-server-workday -e WORKDAY_HOST=<WORKDAY_HOST> -e WORKDAY_TENANT=<WORKDAY_TENANT> -e WORKDAY_CLIENT_ID=<WORKDAY_CLIENT_ID> -e WORKDAY_CLIENT_SECRET=<WORKDAY_CLIENT_SECRET> -e WORKDAY_REFRESH_TOKEN=<WORKDAY_REFRESH_TOKEN> -- npx -y @mindstone/mcp-server-workdayReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add workday --env WORKDAY_HOST=<WORKDAY_HOST> --env WORKDAY_TENANT=<WORKDAY_TENANT> --env WORKDAY_CLIENT_ID=<WORKDAY_CLIENT_ID> --env WORKDAY_CLIENT_SECRET=<WORKDAY_CLIENT_SECRET> --env WORKDAY_REFRESH_TOKEN=<WORKDAY_REFRESH_TOKEN> -- npx -y @mindstone/mcp-server-workdayReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"workday": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-workday"
],
"env": {
"WORKDAY_HOST": "<WORKDAY_HOST>",
"WORKDAY_TENANT": "<WORKDAY_TENANT>",
"WORKDAY_CLIENT_ID": "<WORKDAY_CLIENT_ID>",
"WORKDAY_CLIENT_SECRET": "<WORKDAY_CLIENT_SECRET>",
"WORKDAY_REFRESH_TOKEN": "<WORKDAY_REFRESH_TOKEN>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"workday": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-workday"
],
"env": {
"WORKDAY_HOST": "<WORKDAY_HOST>",
"WORKDAY_TENANT": "<WORKDAY_TENANT>",
"WORKDAY_CLIENT_ID": "<WORKDAY_CLIENT_ID>",
"WORKDAY_CLIENT_SECRET": "<WORKDAY_CLIENT_SECRET>",
"WORKDAY_REFRESH_TOKEN": "<WORKDAY_REFRESH_TOKEN>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e WORKDAY_HOST=<WORKDAY_HOST> -e WORKDAY_TENANT=<WORKDAY_TENANT> -e WORKDAY_CLIENT_ID=<WORKDAY_CLIENT_ID> -e WORKDAY_CLIENT_SECRET=<WORKDAY_CLIENT_SECRET> -e WORKDAY_REFRESH_TOKEN=<WORKDAY_REFRESH_TOKEN> workday npx -y @mindstone/mcp-server-workdayReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Workday
How to install Workday in Claude Code?
Run this command: `claude mcp add mcp-server-workday -e WORKDAY_HOST=<WORKDAY_HOST> -e WORKDAY_TENANT=<WORKDAY_TENANT> -e WORKDAY_CLIENT_ID=<WORKDAY_CLIENT_ID> -e WORKDAY_CLIENT_SECRET=<WORKDAY_CLIENT_SECRET> -e WORKDAY_REFRESH_TOKEN=<WORKDAY_REFRESH_TOKEN> -- npx -y @mindstone/mcp-server-workday`
What does the Workday MCP server do?
It connects AI hosts to Workday HCM via OAuth 2.0, providing nine read tools for employees, direct reports, organizations, time off, and requisitions.
What permissions are needed in Workday?
The service account must have domain access to Absence Management for leave data and Recruiting for job requisitions. Without these domain permissions, queries to those tools return errors.
