Opsyn

A workflow automation platform that combines MCP (Model Context Protocol) servers with a visual workflow builder. Create and execute multi-step automation workflows connecting various services like Slack, GitHub, Notion, Airtable, Google services, and more.

Features

• Visual Workflow Builder: Drag-and-drop interface using ReactFlow
• MCP Protocol Support: STDIO and HTTP/SSE transports
• Multiple Integrations: Slack, GitHub, Notion, Airtable, Gmail, Google Drive, Google Calendar, Google Sheets
• DAG Execution: Topological ordering with dataflow templating
• Context Passing: Share data between workflow nodes using {{ ctx.nodeId.field }} syntax
• Error Handling: Configurable continueOnError option

Setup

Prerequisites

• Node.js 18+
• Python 3 (for some Google Calendar integrations)
• Google Cloud OAuth credentials for Google services

Installation

1. Clone the repository:

git clone https://github.com/Z-vren/opsyn-mcp.git
cd opsyn-mcp

2. Install dependencies:

npm install
cd canvas-ui && npm install && cd ..

3. Set up environment variables:

cp .env.example .env
# Edit .env with your actual API tokens

4. Set up Google OAuth (for Gmail, Drive, Calendar, Sheets):

   Option A: Automated setup (Windows PowerShell)

   .\bootstrap-google.ps1 -ClientSecretJson "path\to\your\client_secret.json"
   

   Option B: Manual setup

   • Create directories: .gdrive, .gmail, .gcal, .gsheets
   • Place client_secret.json in each directory
   • Run token generation scripts:

     node get_gdrive_token.mjs
     node get_gmail_token.mjs
     node get_gcal_token.mjs
     node get_gsheets_token.mjs
     

Usage

Start the API Server

node opsyn-api.mjs

The API will be available at http://localhost:3000 (or port specified in config).

Start the Visual Workflow Builder

cd canvas-ui
npm run dev

Open http://localhost:5173 in your browser.

Start MCP Server (STDIO)

node opsyn-mcp-server.mjs

Start HTTP/SSE MCP Server

node opsyn-mcp-http.js

Project Structure

• opsyn-api.mjs - Main workflow execution engine and REST API
• opsyn-mcp-server.mjs - MCP server over STDIO
• opsyn-mcp-http.js - MCP server over HTTP/SSE
• workflow-proxy-stdio.mjs - Bridge STDIO MCP to HTTP REST API
• canvas-ui/ - React-based visual workflow builder
• workflows.json - Stored workflow definitions
• .gdrive/, .gmail/, .gcal/, .gsheets/ - Google OAuth credentials (not in repo)

Security

⚠️ IMPORTANT: Never commit sensitive files to version control:

• .env file
• client_secret.json files
• token.json files
• credentials.json files
• workflows.json (may contain sensitive data)

All sensitive files are excluded via .gitignore.

License

ISC