Skip to content

commune-dev/n8n-nodes-commune

Repository files navigation

n8n-nodes-commune

n8n community node for Commune — email infrastructure for AI agents.

Give your n8n workflows a real email address: send and receive email, manage inboxes, search conversations, and extract structured data — no code required.

Installation

In your n8n instance, go to Settings → Community Nodes and install:

n8n-nodes-commune

Or install manually:

npm install n8n-nodes-commune

Credentials

  1. Sign in to the Commune Dashboard
  2. Go to API Keys and click Create API Key
  3. In n8n, add a new Commune API credential and paste your key (comm_...)

The credential includes a test button that pings GET /v1/inboxes to verify your key.

Nodes

Commune (Action Node)

Perform operations against the Commune API:

Resource Operations
Message Send, List
Inbox Create, List, Get, Update, Delete, Set Webhook, Set Extraction Schema
Thread List, Get Messages, Update Status
Search Search Threads
Delivery Get Metrics

Commune Trigger

Starts a workflow automatically when an email arrives in an inbox. Registers a webhook on the inbox when the workflow is activated, and removes it when deactivated.

Output fields (Message mode):

Field Description
message_id Unique message ID
thread_id Conversation thread ID
inbox_id Inbox the email arrived at
inbox_address Full inbox email address
subject Email subject
body_text Plain text body
body_html HTML body
from Sender email address
extracted_data Structured data extracted by your schema
spam_flagged Whether the email was flagged as spam
prompt_injection Whether prompt injection was detected
received_at ISO timestamp
has_attachments Whether the email has attachments
attachment_ids Array of attachment IDs

Example Workflows

Customer Support Auto-Triage

Commune Trigger (inbound email)
  → OpenAI (classify intent from extracted_data)
  → If (urgent?)
     → Slack (alert support team)
  → Commune: Message → Send (auto-acknowledge reply)
  → Commune: Thread → Update Status (open)

Sales Lead Qualification

Commune Trigger (inbound email)
  → Commune: Thread → Get Messages (full context)
  → OpenAI (score lead quality)
  → HubSpot (Create/Update Contact)
  → Commune: Message → Send (personalised follow-up)

Inbox Health Monitor

Schedule Trigger (daily 9am)
  → Commune: Delivery → Get Metrics (last 24h)
  → If (bounce_rate > 5%?)
     → Slack (alert deliverability degradation)

Links

About

n8n community node for Commune — email infrastructure for AI agents

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors