Workato

You run a Workato MCP Server to interact with Workato’s API through a dedicated MCP endpoint. It lets you manage recipes, connections, connectors, folders, projects, and activity logs from your MCP client with secure, centralized access.

How to use

You connect to the Workato MCP Server from your MCP client to perform common automation tasks. Use the server to manage recipes (list, create, start, stop), monitor execution jobs, handle connections and connectors, organize assets with folders and projects, and review activity logs across environments. Use the provided environment variable to authorize requests and start the server as a local stdio process so your client can communicate via the MCP protocol.

How to install

Prerequisites: ensure you have a supported runtime environment for running Node.js based MCP servers. You will also need a supported package manager installed.

# Install dependencies
npm install
# or
yarn install

Build the server so it can be run locally by your MCP client.

npm run build

Add the server to your MCP client configuration. The example shows how to run the server locally as a stdio process. Use the full path to your built server file.

{
  "type": "stdio",
  "name": "workato_tools",
  "command": "node",
  "args": ["/path/to/your/project/dist/server.js"],
  "env": {
    "WORKATO_API_TOKEN": "your_token_here"
  }
}

Alternative configuration for Cursor via the project-specific MCP settings file.

{
  "mcpServers": {
    "workato-tools": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "WORKATO_API_TOKEN": "your_token_here"
      }
    }
  }
}

If you use Claude Desktop, place the configuration in the Claude desktop config file and restart the application for changes to take effect.

{
  "mcp_servers": {
    "workato-tools": {
      "command": "node",
      "args": ["/path/to/your/project/dist/server.js"],
      "env": {
        "WORKATO_API_TOKEN": "your_token_here"
      }
    }
  }
}

Additional configuration notes

Environment variables shown here are required for the server to operate with your MCP client. Keep tokens secure and do not commit them in public repositories.

You can switch between Cursor and Claude Desktop configurations as your workflow requires. Each method stores the MCP server details locally to enable automatic loading when you start your project in the chosen client.

Security and maintenance

Protect your API token and limit access to your MCP server. Regularly rotate credentials and review environment variable permissions. Keep dependencies up to date by running the install/build steps again when security updates are released.

Troubleshooting tips

If the server fails to start, verify that the dist/server.js file exists at the specified path and that your token is valid. Check that your MCP client is configured to communicate via stdio and that the environment variables are loaded correctly in the client process.

Available tools

list-recipes

List all recipes with filtering options to find, view, or manage existing automations.

create-recipe

Create a new recipe with specified inputs, steps, and settings.

start-recipe

Start a specific recipe to run automated tasks.

stop-recipe

Stop a running recipe to halt automation.

list-connections

List all connections configured for integration with Workato.

create-connection

Create a new connection to an external service.

list-connectors

Get metadata for specific connectors to understand capabilities.

list-all-connectors

List all available connectors and their supported operations.

list-folders

List folders to organize recipes, connections, and assets.

create-folder

Create a new folder for organizing work items.

update-folder

Modify properties of an existing folder.

list-projects

List all projects within your workspace.

update-project

Update details for a project.

list-api-endpoints

List all API endpoints with optional filtering by collection.

list-activity-logs

Retrieve activity logs with filtering by time, users, and event types.

list-tags

List and filter tags with options for title, description, and usage.

create-tag

Create a new tag with a title, description, and color.

update-tag

Modify an existing tag’s properties.

delete-tag

Remove a tag from your workspace.

manage-tags

Apply or remove tags from recipes and connections.

list-recipe-jobs

View jobs associated with a specific recipe.

get-job

Get detailed information about a particular job.

resume-job

Resume a paused job to continue processing.