Jacobgoren-SB_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

3. Build the Server

npm run build

4. Adding to Cursor This project is designed to be used as an MCP server in Cursor. Here's how to set it up:

5. Open Cursor

6. Go to Cursor Settings > Features > MCP

7. Click + Add New MCP Server

8. 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:

1. 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
   

2. 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"
         }
       }
     }
   }
   

3. 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