Union MCP

An MCP server to use Union tasks, workflows, and apps as tools.

Setup

Clone the repo:

git clone https://github.com/unionai-oss/union-mcp

Install uv and the union-mcp package:

pip install uv
uv sync

Use with Claude Desktop

First, install Claude Desktop.

Then, install the server

mcp install -e . examples/server.py

This will configure the claude_desktop_config.json configuration file located in:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

You should see something like

{
  "mcpServers": {
    "Union MCP": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with-editable",
        "/Users/username/union-mcp",
        "mcp",
        "run",
        "/Users/username/union-mcp/examples/server.py"
      ]
    }
  }
}

Note

Make sure the uv executable is available in /usr/local/bin, otherwise replace command with the full path, e.g. /Users/username/.local/bin/uv

Running a local server

union register --project mcp-testing examples/workflows.py

mcp run examples/server.py --transport sse

npx @modelcontextprotocol/inspector