UiPath Orchestrator MCP Server

An MCP (Model Context Protocol) server that exposes UiPath Orchestrator operations as tools, enabling AI assistants like Claude to interact with your UiPath tenant directly.

Features

23 tools spanning the core Orchestrator APIs:

Related MCP server: ansible-mcp-server

Prerequisites

• Python 3.12+

• A UiPath Cloud account with an external application (OAuth client credentials)

• The following OAuth scopes: OR.Jobs OR.Folders OR.Queues OR.Robots OR.Execution OR.Machines OR.Assets

Creating a UiPath External Application

1. In UiPath Automation Cloud, go to Admin > External Applications

2. Create a new application with Application Scopes (not user scopes)

3. Grant the scopes listed above

4. Copy the Client ID and Client Secret

Installation

Option 1: pip (stdio transport — recommended for local use)

pip install uipath-orchestrator-mcp

Option 2: Run from source

git clone https://github.com/adamstuber/uipath-orchestrator-mcp.git
cd uipath-orchestrator-mcp
pip install .

Option 3: Docker (SSE transport — for remote/shared use)

docker build -t uipath-orchestrator-mcp .
docker run -p 8000:8000 \
  -e UIPATH_CLIENT_ID=your_client_id \
  -e UIPATH_CLIENT_SECRET=your_client_secret \
  -e UIPATH_TENANT_NAME=your_tenant \
  -e UIPATH_ORG_NAME=your_org \
  uipath-orchestrator-mcp

Configuration

Copy .env.example to .env and fill in your credentials:

cp .env.example .env

Usage

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "uipath-orchestrator": {
      "command": "uipath-orchestrator-mcp",
      "env": {
        "UIPATH_CLIENT_ID": "your_client_id",
        "UIPATH_CLIENT_SECRET": "your_client_secret",
        "UIPATH_TENANT_NAME": "your_tenant",
        "UIPATH_ORG_NAME": "your_org"
      }
    }
  }
}

Alternatively, if you use a .env file:

{
  "mcpServers": {
    "uipath-orchestrator": {
      "command": "uipath-orchestrator-mcp"
    }
  }
}

Claude Code (CLI)

claude mcp add uipath-orchestrator uipath-orchestrator-mcp

HTTP transports (Docker or remote server)

Two HTTP-based transports are supported for remote or containerised deployments:

Example with streamable HTTP:

docker run -p 8000:8000 \
  -e MCP_TRANSPORT=streamable-http \
  -e UIPATH_CLIENT_ID=... \
  -e UIPATH_CLIENT_SECRET=... \
  -e UIPATH_TENANT_NAME=... \
  -e UIPATH_ORG_NAME=... \
  uipath-orchestrator-mcp

Then connect your MCP client to http://your-host:8000/mcp.

Example prompts

Once connected, you can ask Claude things like:

• "Show me all faulted jobs from the last 24 hours across all folders."

• "Start the InvoiceProcessing process in the Finance folder."

• "How many Failed items are in the BillingQueue queue?"

• "Retry all failed queue items in the Accounts folder."

• "Disable the nightly schedule for the ReportGenerator process."

• "What robots are available in the Production folder?"

Development

git clone https://github.com/adamstuber/uipath-orchestrator-mcp.git
cd uipath-orchestrator-mcp
pip install poetry
poetry install
cp .env.example .env  # fill in your credentials

Run the server locally (stdio):

poetry run uipath-orchestrator-mcp

Project structure

uipath_orchestrator_mcp/
  __init__.py     # package init
  api.py          # UiPath Orchestrator API client (authentication, OData, retries)
  server.py       # MCP tool definitions (FastMCP)
Dockerfile        # SSE transport container
pyproject.toml

Contributing

Contributions are welcome. Please open an issue before submitting a pull request for significant changes.

1. Fork the repository

2. Create a feature branch (git checkout -b feature/my-feature)

3. Commit your changes

4. Open a pull request

License

MIT — see LICENSE.