n8n-nodes-sunsama

Community node for n8n that wraps the sunsama-api TypeScript client.

It provides a clean n8n-native interface for Sunsama:

• Tasks (query, create, update, delete, reorder)
• Subtasks (add, create, update title, complete/uncomplete)
• Streams (list)
• User profile/timezone
• Calendar events (create/update)
• Utilities (task ID generation)

Features

• Supports session token auth and email/password auth
• Uses the official community wrapper package sunsama-api
• Includes dynamic stream dropdowns loaded from your account
• Designed for self-hosted n8n + community node workflows
• TypeScript codebase with lint/build scripts for maintainers

Installation

In your n8n custom nodes environment

npm install n8n-nodes-sunsama

Then restart n8n.

Local development

git clone https://github.com/gabepaez/n8n-nodes-sunsama.git
cd n8n-nodes-sunsama
npm install
npm run build

Credentials

Create credentials of type Sunsama API and choose one method:

1. Session Token (recommended for automations)
2. Email + Password

Node Resources and Operations

Task

• Get Tasks By Day
• Get Backlog Tasks
• Get Archived Tasks
• Get Task By ID
• Create Task
• Delete Task
• Complete Task / Uncomplete Task
• Update Task Text
• Update Task Snooze Date
• Update Task Planned Time
• Update Task Due Date
• Update Task Stream
• Update Task Notes (HTML/Markdown)
• Reorder Task

Subtask

• Add Subtask
• Create Subtasks
• Update Subtask Title
• Complete Subtask
• Uncomplete Subtask

User

• Get Current User
• Get User Timezone

Stream

• Get All Streams

Calendar Event

• Create Calendar Event
• Update Calendar Event (full JSON payload)

Utility

• Generate Task ID

Example: Get Today’s Tasks

1. Add a Sunsama node
2. Resource: Task
3. Operation: Get Tasks By Day
4. Day: ={{$now.toFormat("yyyy-LL-dd")}}
5. Execute node

This returns one output item per task.

Compatibility

• Node.js >=18.17
• n8n versions compatible with n8n-workflow v1 APIs

Development Scripts

• npm run build - Compile TypeScript and copy static assets
• npm run dev - TypeScript watch mode
• npm run lint - Lint source files
• npm run lint:fix - Auto-fix lint issues
• npm run format - Format source files

Publishing Checklist

Before publishing:

1. Update package.json repository/homepage/bugs URLs
2. Bump version
3. Build and lint
4. Test in a local n8n instance
5. Publish:

npm publish

Security Notes

• Never commit real Sunsama credentials or session tokens
• Prefer n8n credential storage over hardcoded values

Credits

• Built on top of sunsama-api
• n8n community node pattern and APIs from the n8n ecosystem

License

MIT