Workato

Provides a bridge between AI assistants and Workato, exposing recipes, connections, and data operations via MCP.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mirithebest-worka42": {
      "command": "python",
      "args": [
        "/absolute/path/to/worka42/run_mcp.py"
      ],
      "env": {
        "LOG_LEVEL": "INFO",
        "WORKATO_API_TOKEN": "your_workato_api_token_here",
        "WORKATO_API_BASE_URL": "https://www.workato.com/api/"
      }
    }
  }
}

You can run a Workato MCP Server that lets your AI assistant connect to Workato workflows, recipes, and data using the Model Context Protocol. This server acts as the bridge between your AI conversations and the Workato automation platform, enabling dynamic actions and data lookups in conversations.

How to use

Connect your AI assistant to the Workato MCP Server by pointing the assistant to your local MCP configuration. Once connected, you can discover and invoke Workato recipes, inspect connections, read data lookups, and manage projects and deployments through MCP-enabled conversations. Use it to query recipes, fetch versions and health reports, list connections, view execution history, and access data tables or lookups.

In your AI assistant, load the MCP configuration file you created (mcp.json) so the assistant knows where to reach the local MCP server. After loading, start any necessary wrapper or server process and verify the MCP endpoint is reachable from the assistant. When connected, your assistant will expose Workato operations as available tools within conversations.

How to install

Prerequisites you need before installation are: Python 3.10+, Git, and Workato API access (API token and base URL). You will also need an MCP-compatible AI assistant such as Cursor or Claude Desktop.

# Step 1: Clone the project
git clone <your-repository-url>
cd worka42

# Step 2: Install dependencies with uvx
# On Windows (PowerShell)
winget install --id=astral-sh.uv

# On macOS
brew install uv

# On Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Then sync dependencies
uv sync

Step 3: Configure MCP and prepare the client Create and edit the MCP configuration file in your Cursor settings as mcp.json using the template provided by the project. The configuration defines how to start the MCP server locally and which environment variables to pass to it.

Step 4: Start the MCP wrapper or the FastAPI server to expose the MCP service for testing.

Additional configuration and notes

Environment variables you may configure include the Workato API base URL and the API token. These values are used by the MCP server to authenticate with Workato and to route requests correctly.

Remember not to commit sensitive MCP configuration files containing API tokens to version control. Keep mcp.json and related secrets local to your environment.

Troubleshooting

If you encounter issues, verify the MCP configuration location and ensure the mcp.json file contains the correct absolute path to your project and the proper API token. Restart your MCP client after changes and confirm the MCP server starts without errors.

Common checks include ensuring dependencies are installed with uv sync, verifying the wrapper script starts correctly, and testing the Workato API connection using the provided service client.

Available tools

List recipes

Retrieve a paginated list of Workato recipes with optional filtering and health status details.

Get recipe details

Fetch detailed information for a specific recipe, including versions and health reports.

View recipe jobs

Inspect execution history and job status for Workato recipes.

List connections

List Workato connections and their metadata, including connectors and custom connectors.

Access data tables

Query and manipulate lookup tables and data tables within Workato.

Manage projects

View and manage Workato projects and deployments.

List workspace members

List members in the Workato workspace and their privileges.