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.
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
| 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). |
- Open your n8n instance.
- Workflows → Import from File and select the JSON.
- 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>orREPLACE_WITH_ANTHROPIC_CREDENTIAL_ID— they will not work until you replace them in the n8n UI. - 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. - Activate the workflow.
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 inkebab-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>, orREPLACE_WITH_*_CREDENTIAL_IDplaceholders 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/catchfallback so a single malformed response doesn't kill the run. - Each workflow has a
📋 Log ActionCode node that prints a one-line audit log per item.
- Build and test the workflow in n8n.
- Sanitize: replace credential IDs and any account-specific resource IDs with placeholders. Search the JSON for your email address, real names, and other PII.
- Workflows → ⋯ → Download to export the JSON.
- Save it to
workflows/<descriptive-kebab-case-name>.json. - Add a row to the Available workflows table above.
- Open a PR. The reviewer (human or agent) will run the checklist in
skills/n8n-workflow.md.
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.cursorrulesas 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.
Internal Suave Tech Solutions repo. Treat the workflow JSON as proprietary unless explicitly cleared for external sharing.