---
slug: "workato-mcp服务器"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/jacobgoren-sb/workato-mcp-server@main/README.md"
repo: "https://github.com/jacobgoren-sb/workato-mcp-server"
source_file: "README.md"
branch: "main"
---
🤖 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
```bash
npm install
# or
yarn install
```

3. Build the Server
```bash
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:

1. Open Cursor
2. Go to Cursor Settings > Features > MCP
3. Click + Add New MCP Server
4. 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:

```json
{
  "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:
   ```bash
   # 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:
   ```json
   {
     "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