Description

n8n-nodes-microsoft-planner

This is an n8n community node that allows you to interact with Microsoft Planner in your n8n workflows.

n8n is a fair-code licensed workflow automation platform.

Microsoft Planner is a task management tool that helps teams organize, assign, and collaborate on tasks.

Installation

Follow the installation guide in the n8n community nodes documentation.

Community Node

1. Go to Settings > Community Nodes in your n8n instance
2. Select Install
3. Enter @blickwerk/n8n-nodes-microsoft-planner in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install

After installing the node, you can use it like any other node in your workflows.

Manual Installation

To install manually:

npm install @blickwerk/n8n-nodes-microsoft-planner

Setup

Takes about 5 minutes. You need a Microsoft 365 work or school account. For step 2 you also need an admin (or someone allowed to grant admin consent) – if that’s not you, send them steps 1-3.

1. Register an app in Microsoft Entra ID

1. In n8n, go to Credentials → Add credential → Microsoft Planner OAuth2 API and copy the OAuth Redirect URL shown at the top. Leave the dialog open.
2. Open the n8n community nodes documentation

Microsoft Graph Planner API documentation

Microsoft Graph Explorer

Version History

1.6.1

Simpler login: the credential now only asks for Client ID, Client Secret and Tenant ID. The login URLs are built automatically, so single-tenant app registrations no longer fail with AADSTS50194.

Setup guide rewritten as 4 short steps, with a troubleshooting table for the common Entra ID errors

The package no longer ships the TypeScript build cache; CI uses actions/checkout and actions/setup-node v7

1.6.0

Migrated to the current n8n community node tooling

– @n8n/node-cli for build, lint, dev and release, ESLint 9 flat config, strict mode
– GitHub Actions workflows for CI and npm publishing with provenance (required by n8n since May 2026)
– Node is usable as an AI agent tool; correct item pairing (pairedItem) for all operations

New Features

– Task labels (applied categories) on create and update; the label dropdown shows the plan’s label names
– Get Many Tasks for My Tasks and User, optional Include Details and Exclude Completed Tasks
– Get Many Plans for a specific User
– Task Get Board Format / Update Board Format (Bucket, Progress, Assigned To views)
– Task update: Assignment Mode (Append/Replace), Remove Assignees, Remove Due/Start Date, remove checklist items by ID, remove attachments by URL
– Task: Order Hint, Assignee Priority, Preview Type and Conversation Thread ID fields
– Checklist items: Order Hint; attachments: Preview Priority
– Bucket create: Order Hint
– Comments: Split Into Items option, pagination for threads with many posts
– Search filter for the Bucket and Group dropdowns

Bug Fixes

– Task update priority values were wrong (“Urgent” sent 0, “Important” sent 1, which Planner treats as urgent). Now 1/3/5/9, the same as on create
– Replying to an existing comment thread used an invalid endpoint (the conversation ID was taken from the thread). Now uses /groups/{id}/threads/{id}/reply
– Creating the first comment relied on threads in the create-conversation response, which Graph does not return
– Plain-text comments were not HTML-escaped (<, & broke the comment) and lost line breaks
- The OAuth scope was missing User.Read / User.ReadBasic.All, so assigning users by email could fail
- Plans are now created with container instead of the deprecated owner property
- Empty Attachments/Checklist sections no longer send an empty PATCH request
- The description can now be cleared on update
- Dates passed as Luxon DateTime/Date objects (e.g. {{ $now }}) were dropped
- Email addresses containing ' broke the user lookup filter
- ETag conflicts (HTTP 412) are retried automatically instead of failing the workflow
- Errors now reference the failing item

1.5.5

Bug Fix: $select Duplication

- Fixed an issue where the $select query parameter was sent twice during pagination, causing "Query option '$select' was specified more than once" error.

1.5.4

New Feature: $select Support

- Added "Select Properties" field to "Get Many" operations for Tasks, Plans, Buckets, and Comments.

Improved Task Assignments

- Fixed silent failures for task assignments.
- Added robust user lookup (ID, Email, UPN) and error reporting for missing users.
- Added support for Array inputs (expressions) in the "Assigned To" field.

1.5.3

UI Improvements for Attachments and Checklists

- Refactored to use a grouped UI pattern for better usability
- Replaced separate fields with a unified structure using fixedCollection

Updated Logic for Updates

- Replaced "Replace All" toggle with a clearer Operation Mode dropdown (Append vs Replace)
- Renamed "Mode" to "Input Mode" for better clarity between Manual and JSON inputs
- Fixed logic for replacing items with matching IDs during updates

1.5.2

Maintenance release

Removed runtime dependency on n8n-core to comply with n8n community node requirements

No functional changes to node behavior

1.5.1

Maintenance release

Replaced deprecated requestOAuth2 helper with httpRequestWithAuthentication in Microsoft Planner API requests

Removed console logging from the Microsoft Planner node and helper to satisfy n8n community package scan requirements

1.5.0

Major feature release (with contributions from United Workspace GmbH)

Added Comment Support

- Create and retrieve comments on Planner tasks
- Automatic conversation thread management
- Support for both HTML and plain text comments

Enhanced Task Details

- Checklist Support: Full support for adding and managing checklist items
- Attachments (References): Support for adding external URLs and files to tasks
- Replace All Options: New toggles to replace existing checklists or attachments entirely

Plan Resource Support

- CRUD operations for Plans
- Manage Category Labels (1-25)
- Manage Plan members (Shared With)

Bucket Resource Support

- CRUD operations for Buckets
- Manage bucket names and positioning (Order Hint)

Robust Encoding: Improved handling of special characters in attachment URLs

Internal Improvements: Comprehensive build audit, improved error handling and data fetch reliability

1.4.0

Updated branding

New Planner icon/logo

Added About Blickwerk Media section with company info and social links

1.3.9

Added Get Files operation

Retrieve all files attached to a task

URLs are properly decoded for direct use

Returns file metadata including alias, type, and last modified info

1.3.8

Fixed priority values

Corrected priority mapping: Urgent (1), Important (3), Medium (5), Low (9)

Priority values now match Microsoft Planner API specifications

1.3.7

Fixed Update Task response handling

Fetch complete updated task data after PATCH operation

Always returns full task object with all current values

Fixes empty array and undefined description issues

1.3.6

Improved Update Task response

Update Task now returns complete task data including description

Better user experience with full task details in response

1.3.5

Documentation update

Synced README with npm package (no code changes)

1.3.4

Fixed "Empty Payload" error in Update Task

Update Task now works correctly even when no fields are selected

Only sends PATCH request when there are actual fields to update

Improved error handling for update operations

1.3.3

Restructured Get Many Tasks for better UX

Added "Filter By" dropdown to choose between Plan or Bucket filtering

Plan ID and Bucket are now separate fields (not in collection)

Bucket dropdown now properly loads when Plan ID is entered

Simplified Get/Update/Delete Task to use "By ID" only (no dropdown)

Resource Locator UI for buckets with "From List" / "By ID" toggle

1.3.0 - 1.3.2

Added resource locator UI for Buckets and Tasks

Converted from loadOptions to listSearch methods

Various fixes for dropdown loading issues

1.2.4

Fixed Bucket and Task dropdowns not showing!

Changed field type from 'string' back to 'options' for proper dropdown display

Buckets now load correctly when Plan ID is entered

Tasks dropdown now works properly

1.2.3

Improved error handling for Buckets and Tasks loading

Better fallback values when data cannot be loaded

Added console logging for debugging dropdown issues

1.2.2

Removed Plan dropdown (Plans cannot be loaded via API)

Plan ID is now manual input only

Buckets and Tasks still have dynamic dropdowns

Simplified and more reliable plan selection

1.2.1

Fixed Plans not loading (improved API endpoint to fetch from groups)

Allow manual ID input in all dropdown fields

You can now choose from dropdown OR paste IDs manually

Added placeholders and better descriptions for all ID fields

Improved error handling for plans loading

1.2.0

Major UX Improvement: Added dynamic dropdowns for Plans, Buckets, and Tasks

No more manual ID lookup - select from dropdown menus

Plans load automatically from your Microsoft 365 account

Buckets load dynamically based on selected Plan

Tasks load from selected Plan or Bucket

Improved user experience with clearer field labels

1.1.1

Fixed startDateTime not being set (was returning null)

Fixed user assignment by adding User.Read.All permission requirement

Added error logging for failed user lookups

Improved README documentation with all required permissions

1.1.0

Added priority dropdown (Urgent, Important, Medium, Low) instead of number input

Added user assignment functionality (assign tasks by email)

Improved user experience with better field descriptions

1.0.1

Fixed DateTime format handling (automatic conversion to ISO 8601)

Improved error handling for invalid date formats

1.0.0

Initial release

Support for creating and retrieving Planner tasks

OAuth2 authentication

CRUD operations (Create, Read, Update, Delete)

License

MIT

Author

Developed and maintained by Blickwerk Media UG

Credits

This node was invented and developed by Blickwerk Media UG. United Workspace GmbH contributed to its further development – we thank them for their contributions.

Web: blickwerk.media

Support

For issues, questions, or contributions, please visit the GitHub repository.