Workday HCM MCP server for Model Context Protocol hosts — workers, profiles, organizations
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude 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-workday~/.codex/config.toml
[mcp_servers.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>" }
# 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-workday~/.cursor/mcp.json
{
"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>"
}
}
}
}.vscode/mcp.json
{
"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>"
}
}
}
}~/.gemini/settings.json
{
"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>"
}
}
}
}claude_desktop_config.json
{
"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>"
}
}
}
}.trae/mcp.json
{
"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>"
}
}
}
}Environment variables
WORKDAY_HOSTWORKDAY_TENANTWORKDAY_CLIENT_IDWORKDAY_CLIENT_SECRETWORKDAY_REFRESH_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.