usb-workday-agent 1.1.4

USB Workday Agent - MCP integration for Workday automation with employee time tracking, PTO balances, and holiday calendar tools

USB Workday Agent

MCP integration for Workday automation.

Overview

This project provides an MCP (Model Context Protocol) server for automating Workday operations. It leverages the FastMCP framework to expose tools and resources for Workday integration.

Prerequisites

• Python 3.10 or higher
• a virtual environment
• MCP-compatible client (e.g., Claude Desktop, Bob)

Installation

Create a new virtual environment:

# Create virtual environment
python -m venv venv

# Activate virtual environment
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e .

Development

Install Development Dependencies

pip install -e ".[dev]"

Code Formatting

# Format code with black
black .

# Lint with ruff
ruff check .

Testing

pytest

Project Structure

usb-workday-agent/
├── README.md
├── pyproject.toml
├── setup.py
└── (source files to be added)

Dependencies

• mcp (>=0.9.0): Model Context Protocol core library
• fastmcp (>=3.0.0): FastMCP framework for building MCP servers

Running the MCP Server

Start the Server

# Activate the wxO-nit virtual environment
source ../wxO-nit/bin/activate

# Run the server directly
python3 server.py

# Or use the installed command (after pip install -e .)
usb-workday-agent

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

{
  "mcpServers": {
    "usb-workday-agent": {
      "command": "python3",
      "args": [".../usb-workday-agent/server.py"],
      "env": {
        "PYTHONPATH": ".../lib/python3.10/site-packages"
      }
    }
  }
}

Available Tools

The server provides the following tools for watsonx Orchestrate:

• get_employee_daily_hours: Get an employee's office wifi and VPN hours for a specific date
• get_employee_session_details: Get detailed session information for an employee
• get_employee_weekly_summary: Get an employee's weekly attendance summary
• get_team_attendance_stats: Get attendance statistics for a manager's team
• query_individual_time: Query data from individual employee office time logs

Available Resources

• workday://config: Get Workday configuration details
• workday://status: Check connection status to Workday

Configuration

Workday API credentials and configuration should be set via environment variables:

export WORKDAY_TENANT="your-tenant"
export WORKDAY_USERNAME="your-username"
export WORKDAY_PASSWORD="your-password"
export WORKDAY_API_VERSION="v1"

License

MIT License

Author

Amanda Winkles