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 ```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