Skip to main content
Workday is a leading enterprise cloud platform for human capital management, financial management, and planning. The Workday MCP server lets you download custom reports from Workday using natural language.

​
What Can It Do?

  • Download custom reports from Workday using report URLs
  • Export data to your workspace for further processing
The Workday integration downloads report files from Workday. To parse the file contents, perform data analysis, or do any operations on the downloaded data, add the Code Sandbox tool to your agent. This enables your agent to read and process the downloaded files using Python.

​
Where to Use It

Add Workday as a tool to any agent. The agent can then fetch reports conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Enter your Workday credentials
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with Workday tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “Download the employee roster report”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Authentication

Workday uses Basic Authentication with your Workday username and password. When connecting your Workday account, you’ll need to provide:
  • Username: Your Workday username (typically your email or employee ID)
  • Password: Your Workday password
Make sure your Workday account has the necessary permissions to access the reports you want to download. Contact your Workday administrator if you need additional access.

​
Available Tools

ToolDescription
Get ReportDownload a custom report file from Workday using the report URL
The Get Report tool downloads the report file to your workspace. To parse, analyze, or transform the data in the downloaded file, enable the Code Sandbox tool for your agent. This allows the agent to use Python to read JSON, CSV, or other file formats and perform operations on the data.

​
Example Prompts

Use these with your agent or in the Agent Node: Download a report: 
Download the employee roster report from https://wd5.myworkday.com/company/d/task/report.htmld
Save report to workspace: 
Fetch the Q4 headcount report and save it to my workspace as headcount_q4.json

​
Report URL Format

Workday custom reports are accessed via URLs that follow this pattern: 
https://{tenant}.myworkday.com/{company}/d/task/{report_path}
You can find your report URLs in Workday by:
  1. Navigating to the report you want to access
  2. Looking for the “Web Service” or “REST API” URL in the report settings
  3. Copying the full URL to use with this integration

​
Troubleshooting

IssueSolution
Authentication failedVerify your Workday username and password are correct
Report not foundCheck that the report URL is correct and accessible
Permission deniedEnsure your Workday account has access to the requested report
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Timeout errorsLarge reports may take longer to download - try again or contact support
If you’re having trouble accessing reports, work with your Workday administrator to ensure your account has the “Web Service” permission for the reports you need.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the Workday MCP server using your Gumloop credentials.