A Model Context Protocol (MCP) server that exposes the UiPath Orchestrator Cloud API to MCP-compatible clients such as Claude Desktop. Built on the official mcp Python SDK (FastMCP) with async httpx and OAuth2 client credentials authentication.

Features

• OAuth2 client credentials flow against UiPath Cloud Identity Server with automatic token caching and refresh.
• Personal access token (PAT) support via the UIPATH_ACCESS_TOKEN env var.
• Optional Orchestrator folder scoping through X-UIPATH-OrganizationUnitId.
• Typed tool surface covering processes, robots, machines, jobs, queues, and assets.
• Single-retry on 401 with forced token refresh.

Installation

Install from source:

git clone https://github.com/LokiMCPUniverse/uipath-mcp-server.git
cd uipath-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Configuration

All configuration is read from environment variables (prefixed with UIPATH_) or an optional .env file in the working directory.

Variable	Required	Description
UIPATH_ORCHESTRATOR_URL	no	Base URL, defaults to https://cloud.uipath.com.
UIPATH_ORGANIZATION_NAME	yes	Organization (account) logical name.
UIPATH_TENANT_NAME	yes	Tenant logical name.
UIPATH_CLIENT_ID	yes*	OAuth2 client id of the external application.
UIPATH_CLIENT_SECRET	yes*	OAuth2 client secret.
UIPATH_ACCESS_TOKEN	no	Pre-issued access token or PAT (overrides client credentials).
UIPATH_FOLDER_ID	no	Folder id sent via X-UIPATH-OrganizationUnitId.
UIPATH_TIMEOUT	no	HTTP timeout in seconds (default 30).

* Not required if UIPATH_ACCESS_TOKEN is provided.

Running

uipath-mcp

Claude Desktop configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "uipath": {
      "command": "uipath-mcp",
      "env": {
        "UIPATH_ORGANIZATION_NAME": "your-org",
        "UIPATH_TENANT_NAME": "your-tenant",
        "UIPATH_CLIENT_ID": "...",
        "UIPATH_CLIENT_SECRET": "...",
        "UIPATH_FOLDER_ID": "123456"
      }
    }
  }
}

Tools

Tool	Description
list_processes	List Orchestrator processes (Releases).
list_robots	List robots registered in the tenant.
list_machines	List machines registered in the tenant.
start_job	Start a process, optionally with specific robots and input arguments.
list_jobs	List jobs, optionally filtered by state.
get_job	Get a single job by id.
stop_job	Stop or kill a running job (SoftStop or Kill).
list_queue_items	List queue items, optionally filtered by queue name and status.
add_queue_item	Add a new item to a queue with arbitrary specific content.
list_assets	List assets in the current folder.

Development

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
pytest -x --tb=short
ruff check src tests

License

MIT License - see LICENSE file for details