uipath-mcp 0.0.18

UiPath MCP SDK

UiPath MCP Python SDK

A Python SDK that enables hosting local MCP servers on UiPath Platform.

Installation

pip install uipath-mcp

using uv:

uv add uipath-mcp

Configuration

Environment Variables

Create a .env file in your project root with the following variables:

UIPATH_URL=https://cloud.uipath.com/ACCOUNT_NAME/TENANT_NAME
UIPATH_ACCESS_TOKEN=YOUR_TOKEN_HERE

Servers Definition

// mcp.json
{
  "servers": {
    "my-python-server": {
        "type": "stdio",
        "command": "python",
        "args": ["server.py"]
    },
  }
}

Command Line Interface (CLI)

The SDK also provides a command-line interface for creating, packaging, and deploying Python-based MCP servers:

Authentication

uipath auth

This command opens a browser for authentication and creates/updates your .env file with the proper credentials.

Initialize a Project

uipath init [SERVER]

Creates a uipath.json configuration file for your project. If [SERVER] is not provided, it will create an entrypoint for each MCP server defined in the mcp.json file.

Debug a Project

uipath run [SERVER]

Starts the local MCP Server

Package a Project

uipath pack

Packages your MCP Server into a .nupkg file that can be deployed to UiPath.

Note: Your pyproject.toml must include:

• A description field (avoid characters: &, <, >, ", ', ;)
• Author information

Example:

description = "Your package description"
authors = [{name = "Your Name", email = "[e-mail]"}]

Publish a Package

uipath publish

Publishes the most recently created package to your UiPath Orchestrator.

Project Structure

To properly use the CLI for packaging and publishing, your project should include:

• A pyproject.toml file with project metadata
• A mcp.json file with servers metadata
• A uipath.json file (generated by uipath init)
• Any Python files needed for your automation

Development

Setting Up a Development Environment

Please read our contribution guidelines before submitting a pull request.