n8n Workflow Inventory

Complete reference for all automation workflows in n8n.

Overview

n8n provides workflow automation for the RavenmaskOS platform. Workflows are triggered by webhooks, schedules, or events and integrate with various services.

URL: n8n.ravenhelm.dev

Workflow Index

Workflow	Status	Trigger	Description
GitLab Pipeline → Alerting	Active	Webhook	Sends Slack alerts on failed CI/CD pipelines
Bifrost Echo Tool	Active	Webhook	MCP test tool for verifying n8n connectivity
Grocy Shopping Sync	Active	Schedule (30m)	Monitors inventory, alerts on low stock/expiring items
GitLab → Slack Notifications	Inactive	Webhook	Routes GitLab events to Slack

Active Workflows

GitLab Pipeline → Alerting

ID: 2uTyScJHoGvu6LMd Status: Active Trigger: Webhook (/webhook/gitlab-prometheus-alerts)

Monitors GitLab CI/CD pipelines and sends Slack alerts when pipelines fail.

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│ GitLab Webhook  │───▶│ Filter Pipeline │───▶│  Check Failed?  │
│   (POST)        │    │    Events       │    │                 │
└─────────────────┘    └─────────────────┘    └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │  Format Alert   │
                                              │                 │
                                              └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │  Slack #alerts  │
                                              │                 │
                                              └─────────────────┘

Flow:

Receives GitLab webhook events
Filters for pipeline events only
Checks if pipeline status is "failed"
Formats alert with project name, branch, and link
Posts to #alerts Slack channel

Credentials Used:

Slack - The Norns Bot

Bifrost Echo Tool

ID: 3Qe1MAyATJ6B9JPR Status: Active Trigger: Webhook (/webhook/bifrost-echo)

Test tool for the Bifrost MCP Gateway. Echoes back messages to verify n8n connectivity.

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│    Webhook      │───▶│ Build Response  │───▶│    Respond      │
│    (POST)       │    │                 │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

Input:

{
  "arguments": {
    "message": "Hello from Bifrost!"
  },
  "context": {
    "request_id": "uuid",
    "agent_name": "norns"
  }
}

Output:

{
  "success": true,
  "result": {
    "echo": "Hello from Bifrost!",
    "received_at": "2025-01-03T12:00:00Z",
    "request_id": "uuid",
    "agent_name": "norns"
  },
  "metadata": {
    "workflow": "bifrost-echo",
    "version": "1.0"
  }
}

Integration: Called by Bifrost MCP Gateway's n8n_echo tool.

Grocy Shopping Sync

ID: GN9IyNTrmtWzYy5l Status: Active Trigger: Schedule (every 30 minutes)

Monitors Grocy inventory for low stock and expiring items, sends alerts to Slack, and automatically adds items to the shopping list.

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│  Every 30 min   │───▶│ Get Grocy Stock │───▶│  Process Data   │
│   (Schedule)    │    │   (HTTP GET)    │    │                 │
└─────────────────┘    └─────────────────┘    └────────┬────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │   Has Alerts?   │
                                              └────────┬────────┘
                                                       │
                       ┌───────────────────────────────┼───────────────────────────────┐
                       │                               │                               │
              ┌────────▼────────┐            ┌────────▼────────┐            ┌─────────▼────────┐
              │ Log to Postgres │            │ Format Slack Msg │            │   No Alerts      │
              └────────┬────────┘            └────────┬────────┘            └─────────┬────────┘
                       │                              │                               │
              ┌────────▼────────┐            ┌────────▼────────┐                      │
              │Get Shopping List│            │  Slack Notify   │                      │
              └────────┬────────┘            └────────┬────────┘                      │
                       │                              │                               │
              ┌────────▼────────┐                     │                               │
              │ Filter New Items│                     │                               │
              └────────┬────────┘                     │                               │
                       │                              │                               │
              ┌────────▼────────┐                     │                               │
              │Add to Shop List │                     │                               │
              └────────┬────────┘                     │                               │
                       │                              │                               │
                       └──────────────────────────────┴───────────────────────────────┘
                                                       │
                                              ┌────────▼────────┐
                                              │    Log Sync     │
                                              └─────────────────┘

Alerts Generated:

Low Stock: Items below minimum stock level
Expiring Soon: Items expiring within threshold
Expired: Overdue items

Example Slack Message:

:shopping_cart: *Grocy Inventory Alert*

:warning: *Low Stock:*
• Milk (need 2 more)
• Bread (need 1 more)

:calendar: *Expiring Soon:*
• Yogurt - expires in 2 days

:rotating_light: *Expired:*
• Eggs - expired 1 day ago

_View in Grocy: https://grocy.ravenhelm.dev_

Credentials Used:

Grocy API (HTTP Header Auth)
RavenmaskOS PostgreSQL
Slack - The Norns

Database Tables:

home_events - Stores inventory alerts
sync_logs - Tracks sync operations

Inactive Workflows

GitLab → Slack Notifications

ID: H7FcevmapW3CCDbl Status: Inactive Trigger: Webhook

Routes various GitLab events (pushes, merge requests, issues) to appropriate Slack channels.

Note: Superseded by "GitLab Pipeline → Alerting" for CI/CD failures.

Creating New Workflows

For Bifrost MCP Integration

Create workflow with webhook trigger
Set path to bifrost-<tool-name>
Process $json.body.arguments for tool inputs
Return response in format:

{
  "success": true,
  "result": { ... },
  "metadata": { "workflow": "name", "version": "1.0" }
}

Webhook URL Pattern

https://n8n.ravenhelm.dev/webhook/<path>

Environment Variables

Available via $env:

SLACK_PM_CHANNEL_ID - Personal message channel
GROCY_API_KEY - Grocy API authentication

Credentials Reference

Name	Type	Used By
Slack - The Norns Bot	Slack OAuth	GitLab alerting
Slack - The Norns	Slack OAuth	Grocy sync
Grocy API	HTTP Header Auth	Grocy workflows
RavenmaskOS PostgreSQL v2	PostgreSQL	Logging, sync
Anthropic account	Anthropic API	AI workflows
OpenAi account 2	OpenAI API	AI workflows
Perplexity account	Perplexity API	AI workflows
Google Gemini(PaLM) Api	Google API	AI workflows

Overview​

Workflow Index​

Active Workflows​

GitLab Pipeline → Alerting​

Bifrost Echo Tool​

Grocy Shopping Sync​

Inactive Workflows​

GitLab → Slack Notifications​

Creating New Workflows​

For Bifrost MCP Integration​

Webhook URL Pattern​

Environment Variables​

Credentials Reference​

See Also​