Skip to main content
Glama
UiPath MCP Server

UiPath MCP Server

UiPath MCP Server

Uipath Mcp Server

GitHub stars GitHub forks GitHub watchers

License Issues Pull Requests Last Commit

Python MCP

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.

Related MCP server: uipath-orchestrator-mcp

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

Available Tools

10 tools
add_queue_itemC

Add a new queue item to the given UiPath queue.

Args: queue_name: Target queue name. specific_content: Dict of key/value pairs stored on the queue item.

Inputs: queue_name (required), specific_content (required).

get_jobA

Get a single job by its numeric id.

Args: job_id: The Orchestrator job id.

Inputs: job_id (required).

list_assetsA

List assets configured in the current Orchestrator folder.

Args: top: Optional maximum number of items to return.

Inputs: top.

list_jobsA

List jobs, optionally filtered by state.

Args: state: Optional UiPath job state (e.g. Pending, Running, Successful, Faulted, Stopped). top: Optional maximum number of items to return.

Inputs: state, top.

list_machinesB

List UiPath machines registered in the Orchestrator tenant.

Args: top: Optional maximum number of items to return.

Inputs: top.

list_processesB

List UiPath processes (Releases) available in the current folder.

Args: top: Optional maximum number of items to return.

Inputs: top.

list_queue_itemsB

List queue items, optionally filtered by queue name and status.

Args: queue_name: Optional queue name to filter by. status: Optional status filter (e.g. New, InProgress, Successful, Failed). top: Optional maximum number of items to return.

Inputs: queue_name, status, top.

list_robotsB

List UiPath robots registered in the Orchestrator tenant.

Args: top: Optional maximum number of items to return.

Inputs: top.

start_jobB

Start a job for a UiPath process.

Args: process_key: The ReleaseKey of the process to start. robot_ids: Optional list of robot ids. If omitted, a modern dynamic allocation runs one job. input_arguments: Optional dict of input arguments passed to the process.

Inputs: process_key (required), robot_ids, input_arguments.

stop_jobB

Stop or kill a running UiPath job.

Args: job_id: The Orchestrator job id. strategy: One of SoftStop (graceful) or Kill (immediate).

Inputs: job_id (required), strategy.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action (e.g., queue items, jobs, assets, machines, processes, robots), with clear boundaries. No two tools have overlapping purposes.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern using underscores (e.g., list_assets, start_job). Verbs are uniform (add, get, list, start, stop) and nouns are appropriately singular or plural.

    Tool Count5/5

    10 tools is well-scoped for a UiPath Orchestrator management server, covering key operations without being excessive or insufficient.

    Completeness2/5

    Only queue items and jobs have multiple operations; assets, machines, processes, and robots are limited to listing, lacking create, update, or delete. This leaves significant gaps for managing the Orchestrator.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers