UiPath MCP Server

Uipath Mcp Server

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

Uipath MCP Server

README