Skip to content

About

JSON workflows used in n8n to automate various operations

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

sts-n8n-workflows

A library of reusable n8n workflows that we deploy for Suave Tech Solutions clients (and use internally). Each workflow is exported as a self-contained JSON file you can import directly into any n8n instance.

What's in here

sts-n8n-workflows/
├── workflows/                  # Importable n8n workflow JSON files
│   ├── email-organizer-gmail.json
│   └── email-organizer-outlook.json
├── skills/                     # Portable skill docs (every LLM reads these)
│   ├── n8n-workflow.md
│   └── automation-design.md
├── AGENT.md                    # Canonical agent instructions (single source of truth)
├── AGENTS.md                   # Mirror for OpenAI Codex / ChatGPT
├── CLAUDE.md                   # Pointer for Claude Code / Cowork
├── GEMINI.md                   # Pointer for Gemini CLI
├── .cursorrules                # Pointer for Cursor (legacy format)
├── .cursor/rules/project.mdc   # Pointer for Cursor (modern MDC format)
└── .github/copilot-instructions.md  # Pointer for GitHub Copilot

Available workflows

Workflow File Description
AI Gmail Email Organizer workflows/email-organizer-gmail.json Polls Gmail every 5 min, classifies each new message with Claude (Newsletter / NeedsReply / Invoice / FYI / Urgent / Spam), then labels, drafts replies, archives, or stars accordingly. Uses an AI/Reviewed label for idempotency.
AI Outlook Email Organizer workflows/email-organizer-outlook.json Same logic as the Gmail variant, adapted for Microsoft Outlook (uses categories instead of labels, calls Anthropic via HTTP Request node).

Importing a workflow

  1. Open your n8n instance.
  2. Workflows → Import from File and select the JSON.
  3. Open each node with a credential and pick (or create) the matching credential in n8n. Every credential ID in this repo is a placeholder like <OAUTH2_ID_HERE> or REPLACE_WITH_ANTHROPIC_CREDENTIAL_ID — they will not work until you replace them in the n8n UI.
  4. For workflows that reference labels/categories/folders by ID (e.g. Gmail's Label_391513853481320743), update those IDs to match your account, or change the nodes to use label names instead.
  5. Activate the workflow.

Conventions

These rules apply to every workflow we add. Agents (Claude, ChatGPT, Cursor, etc.) are expected to follow them — see AGENT.md for the full spec.

  • One workflow per file in workflows/, named in kebab-case.json.
  • Node names use a leading emoji describing the action (📬 Watch Gmail Inbox, 🤖 Claude AI Classifier, 🔀 Route by Category). This makes workflow diagrams readable at a glance.
  • No real credentials, IDs, tokens, or PII in committed JSON. Replace credential IDs with <OAUTH2_ID_HERE>, <ANTHROPIC_API_KEY_HERE>, or REPLACE_WITH_*_CREDENTIAL_ID placeholders before committing.
  • Idempotency is required for any workflow that processes inbound items. Tag processed items (Gmail label, Outlook category, database row, etc.) and filter them out at the trigger so reruns are safe.
  • AI calls return strict JSON. Prompt the model to return JSON only, then parse it in a Code node with a try/catch fallback so a single malformed response doesn't kill the run.
  • Each workflow has a 📋 Log Action Code node that prints a one-line audit log per item.

Adding a new workflow

  1. Build and test the workflow in n8n.
  2. Sanitize: replace credential IDs and any account-specific resource IDs with placeholders. Search the JSON for your email address, real names, and other PII.
  3. Workflows → ⋯ → Download to export the JSON.
  4. Save it to workflows/<descriptive-kebab-case-name>.json.
  5. Add a row to the Available workflows table above.
  6. Open a PR. The reviewer (human or agent) will run the checklist in skills/n8n-workflow.md.

Working with AI assistants on this repo

This repo is set up so any modern coding agent picks up the same conventions:

  • Claude Code / Cowork reads CLAUDE.md → AGENT.md → skills/*.
  • OpenAI Codex / ChatGPT reads AGENTS.md → AGENT.md → skills/*.
  • Cursor reads .cursor/rules/project.mdc (and .cursorrules as a fallback) → AGENT.md.
  • Gemini CLI reads GEMINI.md → AGENT.md.
  • GitHub Copilot reads .github/copilot-instructions.md → AGENT.md.

If you update conventions, edit AGENT.md and the files under skills/ — every other agent file just points at those.

License

Internal Suave Tech Solutions repo. Treat the workflow JSON as proprietary unless explicitly cleared for external sharing.

About

JSON workflows used in n8n to automate various operations

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors