Automatisch MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with access to Automatisch workflow automation capabilities.

Overview

This MCP server enables AI assistants to interact with Automatisch, an open-source Zapier alternative for workflow automation. It provides tools to manage workflows, connections, executions, and app integrations.

Features

Tools Available

• Workflow Management: Create, read, update, delete, and test workflows

• Connection Management: Manage app connections and credentials

• Execution Monitoring: View workflow execution history and status

• App Discovery: Browse available apps and their capabilities

• Testing: Test workflows with sample data

Resources Provided

• Workflows overview with status summary

• App connections listing

• Available apps catalog

• Recent executions log

Prerequisites

• Node.js 18+

• Running Automatisch instance

• Automatisch API access (API key recommended)

Installation

1. Clone or download the MCP server code

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Configuration

Set environment variables:

# Automatisch instance URL (default: http://localhost:3001)
export AUTOMATISCH_BASE_URL="http://your-automatisch-instance:3001"

# API key for authentication (optional but recommended)
export AUTOMATISCH_API_KEY="your-api-key"

Usage

Claude Desktop Integration

Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "automatisch": {
      "command": "npx",
      "args": ["-y", "automatisch-mcp-server"],
      "env": {
        "AUTOMATISCH_BASE_URL": "http://localhost:3001",
        "AUTOMATISCH_API_KEY": "your-api-key"
      }
    }
  }
}

Standalone Usage

npm start

Available Tools

Workflow Management

• list_workflows - List all workflows with optional filtering

• get_workflow - Get detailed workflow information

• create_workflow - Create new workflow

• update_workflow - Update existing workflow

• delete_workflow - Delete workflow

• test_workflow - Test workflow with sample data

Connection Management

• list_connections - List app connections

• create_connection - Create new app connection

Monitoring & Discovery

• list_executions - View workflow execution history

• get_available_apps - Browse available apps and integrations

Example Usage with AI Assistant

# List all active workflows
"Show me all active workflows"

# Create a new workflow
"Create a workflow named 'Email Notifications' that sends emails when new GitHub issues are created"

# Check recent executions
"Show me the recent workflow executions and their status"

# Get workflow details
"Tell me about the workflow with ID 'abc123'"

# List available apps
"What apps are available for integration?"

API Endpoints

The server interfaces with these Automatisch API endpoints:

• GET /api/flows - List workflows

• POST /api/flows - Create workflow

• PATCH /api/flows/:id - Update workflow

• DELETE /api/flows/:id - Delete workflow

• GET /api/connections - List connections

• POST /api/connections - Create connection

• GET /api/executions - List executions

• GET /api/apps - List available apps

Development

Running in Development Mode

npm run dev

Building

npm run build

Cleaning Build Files

npm run clean

Error Handling

The server includes comprehensive error handling:

• Network connectivity issues with Automatisch

• Invalid API responses

• Missing required parameters

• Authentication failures

Errors are logged and returned as structured responses to the AI assistant.

Security Considerations

• Use API keys for authentication when available

• Ensure Automatisch instance is properly secured

• Limit network access to trusted sources

• Regularly update dependencies

Troubleshooting

Common Issues

1. Connection Failed: Verify AUTOMATISCH_BASE_URL is correct and accessible

2. Authentication Error: Check AUTOMATISCH_API_KEY is valid

3. Tool Not Found: Ensure MCP server is properly registered with Claude Desktop

4. API Errors: Check Automatisch logs for detailed error information

Debug Mode

Enable debug logging by setting:

export NODE_ENV=development

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests if applicable

5. Submit a pull request

License

This project is licensed under the MIT License.

Related Projects

• Automatisch - Open source workflow automation

• Model Context Protocol - Protocol specification

• MCP SDK - TypeScript SDK

Support

For issues related to:

• Issues specific to MCP Server integration or this repository: Open an issue here

• Automatisch: Visit Automatisch GitHub Issues

• MCP Protocol: Check MCP Documentation