Workato MCP Server

🤖 Workato MCP Server Welcome to your Workato API integration toolkit, designed as a Model Context Protocol (MCP) server for Cursor or Claude! This project provides seamless interaction with Workato's API through custom AI tools.

✨ Features 🔄 Recipe Management

List, create, start, and stop recipes
Monitor recipe execution jobs
Manage recipe folders and projects

🔌 Connection Management

List and create connections
View connection details and status
Manage connection configurations

🔍 Connector Discovery

List available connectors and their capabilities
View connector metadata and supported operations
Browse all platform connectors

📂 Folder & Project Organization

Create and manage folders
Organize recipes and connections
Handle project-level configurations

📊 Activity Logs

Track all activities within your workspace
Filter logs by time range, users, and event types
Monitor resource changes and user actions
Support for multiple environments (dev, sandbox, prod, etc.)
Advanced filtering by resource and event types

🔖 Tag Management

Create, update, and delete tags in your workspace
List and retrieve available tags with advanced filtering options
Apply or remove tags from assets (recipes and connections)
Supports batch operations for multiple assets and tags
Filter tags by title, description, author, and usage
Sort tags by various criteria (title, usage count, etc.)
Customize tag appearance with color options

🚀 Getting Started 2. Installation

npm install
# or
yarn install

Build the Server

npm run build

Adding to Cursor This project is designed to be used as an MCP server in Cursor. Here's how to set it up:
Open Cursor
Go to Cursor Settings > Features > MCP
Click + Add New MCP Server
Fill out the form:
- Name: Workato MCP Server
- Type: stdio
- Command: node /path/to/your/project/dist/server.js
- Environment Variables:
  - Click "Add Environment Variable"
  - Name: WORKATO_API_TOKEN
  - Value: your_token_here

📘 Pro Tip: Use the full path to your project's built server.js file.

Alternative Configuration: You can also configure the MCP server using a .cursor/mcp.json file in your project:

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

Using with Claude Desktop: If you're using Claude Desktop instead of Cursor, you can configure the MCP server by editing the Claude desktop configuration:

Open or create the configuration file:
# On macOS ~/Library/Application Support/Claude/claude_desktop_config.json # On Windows %APPDATA%\Claude\claude_desktop_config.json # On Linux ~/.config/Claude/claude_desktop_config.json
Add your MCP server configuration:
{ "mcp_servers": { "workato-tools": { "command": "node", "args": ["/path/to/your/project/dist/server.js"], "env": { "WORKATO_API_TOKEN": "your_token_here" } } } }
Save the file and restart Claude Desktop for the changes to take effect

This method allows you to:

Version control your MCP configuration
Include environment variables directly in the config
Share the same configuration across team members (excluding sensitive values)
Automatically load the server when opening the project in Cursor

🛠️ Available Tools

Recipe Management:

list-recipes: List all recipes with filtering options
create-recipe: Create a new recipe
start-recipe: Start a specific recipe
stop-recipe: Stop a running recipe

Connection Management:

list-connections: List all connections
create-connection: Create a new connection

Connector Tools:

list-connectors: Get metadata for specific connectors
list-all-connectors: List all available connectors

Organization Tools:

list-folders: List all folders
create-folder: Create a new folder
update-folder: Modify folder properties
list-projects: List all projects
update-project: Update project details

API Management:

list-api-endpoints: List all API endpoints with optional filtering by collection

Activity Monitoring:

list-activity-logs: Retrieve detailed activity logs with advanced filtering options
- Filter by time range, users, and event types
- Include or exclude specific resource types
- Track changes across different environments
- Monitor user actions and system events

Tag Management:

list-tags: List and filter available tags in your workspace with advanced query options
create-tag: Create a new tag with custom 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

Job Management:

list-recipe-jobs: View jobs for a specific recipe
get-job: Get detailed job information
resume-job: Resume a paused job

🤝 Contributing Contributions welcome! Please feel free to submit a Pull Request.

📝 License This project is licensed under the MIT License - see the LICENSE file for details.

🐛 Issues & Support Found a bug or need help? Open an issue with:

What you were trying to do What happened instead Steps to reproduce Your environment details

Made with ❤️ by Jacob Goren, for Workato automation

Integrations