[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/milisp-automatisch-mcp-server-badge.png)](https://mseep.ai/app/milisp-automatisch-mcp-server)

# Automatisch MCP Server

[![npm version](https://img.shields.io/npm/v/automatisch-mcp-server)](https://www.npmjs.com/package/automatisch-mcp-server)
[![npm downloads](https://img.shields.io/npm/dm/automatisch-mcp-server)](https://www.npmjs.com/package/automatisch-mcp-server)
[![bundle size](https://img.shields.io/bundlephobia/min/automatisch-mcp-server)](https://bundlephobia.com/result?p=automatisch-mcp-server)

A Model Context Protocol (MCP) server that provides AI assistants with access to [Automatisch](https://github.com/automatisch/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:
   ```bash
   npm install
   ```

3. Build the project:
   ```bash
   npm run build
   ```

## Configuration

Set environment variables:

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

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

### Standalone Usage

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

```bash
npm run dev
```

### Building

```bash
npm run build
```

### Cleaning Build Files

```bash
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:
```bash
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](https://github.com/automatisch/automatisch) - Open source workflow automation
- [Model Context Protocol](https://modelcontextprotocol.io/) - Protocol specification
- [MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk) - TypeScript SDK

## Support

For issues related to:
- **Issues specific to MCP Server integration or this repository**: [Open an issue here](https://github.com/milisp/automatisch-mcp-server/issues)
- **Automatisch**: Visit [Automatisch GitHub Issues](https://github.com/automatisch/automatisch/issues)
- **MCP Protocol**: Check [MCP Documentation](https://modelcontextprotocol.io/)