n8n-nodes-gmail-custom 0.6.0 → 0.6.1

package/README.md

@@ -1,66 +1,79 @@
 # n8n-nodes-gmail-custom
 
-Self-contained n8n node for sending emails via Gmail API with a Google service account and domain-wide delegation.
+Self-contained n8n nodes for Gmail API via Google service accounts with domain-wide delegation. No n8n credential setup required — all parameters inline, supports expressions.
 
-No credential setup in n8n required — all parameters are inline, supports expressions.
+## Nodes
 
-## Features
+| Node | Description |
+|---|---|
+| **Gmail Custom** | Send emails via Gmail API |
+| **Gmail Trigger Custom** | Poll Gmail for new messages on a schedule |
+| **Gmail Get Custom** | Get a single Message or Thread by ID |
 
-- **Self-contained**: service account email + private key are node parameters (no n8n credential needed)
-- **Token caching**: access token reused for 58 minutes — only 1 oauth call per hour instead of per email
-- **Domain-wide delegation**: send as any user in your Workspace domain
-- **Sender name**: set a display name without extra API calls
-- **Optional custom Message-ID**: auto-generated `<uuid@domain>` or specify your own — included in output
-- **Attachments**: from binary data with graceful skip if missing
-- **HTML and plain text email support**
+All three share the same token cache — only 1 oauth call per hour across all nodes.
 
 ## Installation
 
 In n8n: **Settings → Community Nodes → Install** → `n8n-nodes-gmail-custom`
 
-## Usage
-
-1. Add a **Gmail Custom** node to your workflow
-2. Fill in the required fields (supports expressions):
-
-| Field | Description | Example |
-|---|---|---|
-| Service Account Email | Your SA `client_email` | `sa-name@project.iam.gserviceaccount.com` |
-| Private Key | RSA private key (PEM, hidden) | Expression from a previous node |
-| From Email | The user to impersonate (DWD) | `sender@your-domain.com` |
-| To | Recipient(s), comma-separated | `recipient@example.com` |
-| Subject | Email subject | `Hello World` |
-| Email Type | `HTML` or `Text` | `HTML` |
-| Message | Email body | Your HTML or text |
-
-3. Configure **Options** as needed:
-   - **CC / BCC**: carbon copy recipients
-   - **Reply To**: reply-to address
-   - **Sender Name**: display name (e.g. `John Doe`)
-   - **Attachments**: binary data field names from previous nodes
-   - **Custom Message-ID**: enable and optionally specify a `Message-ID` header. Auto-generated as `<uuid@domain>` if left empty. Returned in the node output.
-
-## Output
-
-```json
-{
-  "id": "19ef486e4ed521e6",
-  "threadId": "19ef486e4ed521e6",
-  "labelIds": ["SENT"],
-  "messageId": "<generated-uuid@your-domain.com>"
-}
-```
-
-`messageId` is only present when the Custom Message-ID option is enabled.
-
-## How it works
-
-1. Signs a JWT with the service account private key
-2. Obtains an access token from `oauth2.googleapis.com/token` (cached)
-3. Builds a MIME email message
-4. Sends via `POST gmail.googleapis.com/gmail/v1/users/me/messages/send`
-
-Per email sent: **1 Gmail API call** (token is cached for 1 hour).
+## Gmail Custom (Send)
+
+Sends an email via Gmail API. Supports HTML/text body, CC, BCC, Reply-To, attachments (with graceful skip), sender name, and optional custom Message-ID.
+
+| Field | Description |
+|---|---|
+| Service Account Email | SA `client_email` (JWT `iss`) |
+| Private Key | RSA PEM key (hidden) |
+| From Email | User to impersonate via DWD (JWT `sub`) |
+| To | Recipient(s), comma-separated |
+| Subject | Email subject |
+| Email Type | `HTML` or `Text` |
+| Message | Email body |
+
+Options: CC, BCC, Reply-To, Sender Name, Attachments (binary data), Custom Message-ID (auto-generated `<uuid@domain>` if empty).
+
+Output: `{ id, threadId, labelIds, messageId }` (messageId only when Custom Message-ID enabled).
+
+## Gmail Trigger Custom (Polling)
+
+Polls Gmail inbox on a schedule and returns new messages. State persists between polls via workflow static data.
+
+| Field | Description |
+|---|---|
+| Service Account Email | SA `client_email` |
+| Private Key | RSA PEM key |
+| Delegated Email | Mailbox to monitor (impersonated user) |
+| Simplify | `true` = metadata only, `false` = raw |
+| Max Emails per Poll | 1-50, excess queued for next poll |
+| Mark as Read | Optional: marks processed emails as read (+1 API call per email) |
+
+Filters: Include Spam/Trash, Include Drafts, Label IDs, Search query, Read Status, Sender.
+
+Output: `[{ json: { id, threadId, labelIds, payload, ... } }]` — flat headers when simplify is true.
+
+## Gmail Get Custom (Message / Thread)
+
+Retrieves a single message or thread by ID.
+
+| Field | Description |
+|---|---|
+| Service Account Email | SA `client_email` |
+| Private Key | RSA PEM key |
+| Delegated Email | Mailbox to access |
+| Resource | `Message` or `Thread` |
+| Message ID / Thread ID | The Gmail ID to retrieve |
+| Simplify | `true` = metadata with flat headers, `false` = raw |
+| Return Only Messages | (Thread only) Return message array without thread wrapper |
+
+**Get Message output** (simple): `{ id, threadId, labelIds, snippet, From, To, Subject, Cc, Bcc, ... }`
+
+**Get Thread output** (simple): `{ id, historyId, messages: [{ id, From, To, Subject, ... }, ...] }`
+
+## Token caching
+
+Access token is cached in-memory for 58 minutes (3500 seconds). Cache key: `${serviceAccountEmail}:${delegatedEmail}`. All three nodes share the same cache.
+
+Per-email API calls: **1 Gmail API call** after the first oauth call of the hour.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "n8n-nodes-gmail-custom",
-	"version": "0.6.0",
+	"version": "0.6.1",
 	"description": "Custom Gmail nodes for n8n — Send, Trigger, Get (Message+Thread) — token caching, self-contained",
 	"keywords": [
 		"n8n-community-node-package",