Skip to main content

​
Overview

Microsoft Planner’s task management and collaboration platform for teams. Through Langdock’s integration, you can access and manage Microsoft Planner directly from your conversations.
Authentication: OAuth Category: Productivity & Collaboration Availability: All workspace plans

​
Available Actions

​
List groups

microsoft_planner.list_groups
Retrieve all Microsoft 365 groups that the user is a member of. These groups can contain Planner plans. Requires Confirmation: No Parameters: None Output: Returns the operation result

​
List plans

microsoft_planner.list_plans
Retrieve all Planner plans and Microsoft To Do lists that the user has access to Requires Confirmation: No Parameters:
  • groupId (ID, Optional): ID of the Planner group to get plans from. Leave empty to get plans from all accessible groups. Note: To Do lists are not filtered by group.
  • includeDetails (BOOLEAN, Optional): Include additional plan details such as categories and shared information
  • includeToDo (BOOLEAN, Optional): Include Microsoft To Do lists alongside Planner plans. Defaults to false.
Output: Returns the operation result

​
Create plan

microsoft_planner.create_plan
Create a new Planner plan in a Microsoft 365 group Requires Confirmation: No Parameters:
  • groupId (ID, Required): ID of the Microsoft 365 group where the plan will be created. The user must be a member of this group.
  • title (TEXT, Required): Title of the new plan
Output: Returns the operation result

​
Get plan

microsoft_planner.get_plan
Retrieve details of a specific Planner plan Requires Confirmation: No Parameters:
  • planId (ID, Required): ID of the plan to retrieve
  • includeDetails (BOOLEAN, Optional): Include additional plan details such as categories and shared information
Output: Returns the operation result

​
List tasks

microsoft_planner.list_tasks
Retrieve tasks from a Planner plan or a Microsoft To Do list Requires Confirmation: No Parameters:
  • planId (ID, Optional): ID of the Planner plan to get tasks from. Either planId OR todoListId/todoListName must be provided.
  • todoListId (ID, Optional): ID of the Microsoft To Do list to get tasks from. Use this instead of planId for private To Do tasks.
  • todoListName (TEXT, Optional): Name of the Microsoft To Do list to get tasks from. Used as an alternative to todoListId.
  • includeDetails (BOOLEAN, Optional): Include additional task details such as description, checklist, and references (Planner only)
Output: Returns the operation result

​
Create task

microsoft_planner.create_task
Creates a new task in a Planner plan or as a private To Do task. For Planner tasks, provide planId or planTitle. For private To Do tasks, set isPrivate=true or provide todoListName. Requires Confirmation: No Parameters:
  • planId (ID, Optional): Unique identifier of the Planner plan where the task will be created. Either plan id/title OR isPrivate/todoListName must be provided.
  • planTitle (TEXT, Optional): Name of the Planner plan where the task will be created. Used as an alternative to plan id. If multiple plans match the title, an error with candidates is returned.
  • isPrivate (BOOLEAN, Optional): Create the task as a private Microsoft To Do task in your default task list. Use this instead of planId/planTitle for personal tasks.
  • todoListName (TEXT, Optional): Name of the Microsoft To Do list where the private task will be created. Leave empty to use the default ‘Tasks’ list.
  • title (TEXT, Required): Title of the new task
  • description (TEXT, Optional): Detailed notes or description for the task. Supports plain text.
  • bucketId (ID, Optional): Unique identifier of the bucket where the task will be placed. If not provided, the task is placed in the plan’s default bucket.
  • bucketName (TEXT, Optional): Name of the bucket where the task will be placed. Used as an alternative to bucket id. If not found, the task is placed in the plan’s default bucket.
  • assignedToUserIds (ID, Optional): User ids to assign the task to. Supports comma-separated values for multiple assignees.
  • assignedToEmails (TEXT, Optional): Email addresses (UPNs) to assign the task to. Supports comma-separated values for multiple assignees.
  • assignToMe (BOOLEAN, Optional): Assigns the task to the current user. Only applies if no other assignee is provided.
  • startDateTime (TEXT, Optional): Start date of the task in ISO 8601 format with timezone, e.g., 2025-08-01T09:00:00Z or 2025-08-01T09:00:00+02:00
  • dueDateTime (TEXT, Optional): Due date of the task in ISO 8601 format with timezone, e.g., 2025-08-13T17:00:00Z or 2025-08-13T17:00:00+02:00
  • percentComplete (SELECT, Optional): Completion status of the task. Use 0% for not started, 50% for in progress, or 100% for completed.
  • priority (SELECT, Optional): Priority level of the task
  • appliedCategories (TEXT, Optional): Comma-separated list of category labels to apply (category1 through category25). The actual label names are defined in the plan settings.
  • checklist (TEXT, Optional): Comma-separated list of checklist items to add to the task
  • previewType (SELECT, Optional): Controls what content is shown on the task card in the Planner board view
  • orderHint (TEXT, Optional): Hint used to order the task within a bucket. Leave empty for automatic ordering.
Output: Returns the operation result

​
Search my tasks

microsoft_planner.search_my_tasks
Search and filter tasks assigned to you across Planner plans and Microsoft To Do lists. Filter by date, priority, and progress. Requires Confirmation: No Parameters:
  • planId (ID, Optional): ID of a specific Planner plan to search in. Leave empty to search across all accessible Planner plans and Microsoft To Do lists.
  • priority (SELECT, Optional): Filter tasks by priority level
  • progress (SELECT, Optional): Filter tasks by completion status
  • dueDate (TEXT, Optional): Filter tasks due on or before this date (ISO 8601 format, e.g., 2025-08-31T23:59:59Z)
  • includeDetails (BOOLEAN, Optional): Include additional task details such as description, checklist, and references (Planner only). Default is false.
  • includeToDo (BOOLEAN, Optional): Include Microsoft To Do tasks alongside Planner tasks. Defaults to true.
Output: Returns the operation result

​
Update task

microsoft_planner.update_task
Updates an existing task in a Planner plan. This only works for Planner tasks - for To Do tasks, use the Microsoft To Do integration. Requires Confirmation: No Parameters:
  • taskId (ID, Required): Unique identifier of the Planner task to update
  • source (SELECT, Optional): Specify whether this is a Planner task. If not provided, auto-detection will be attempted.
  • title (TEXT, Optional): New title for the task. Leave empty to keep the current title.
  • description (TEXT, Optional): Detailed notes or description for the task. Supports plain text. Leave empty to keep the current description.
  • bucketId (ID, Optional): Unique identifier of the bucket to move the task to. Leave empty to keep the current bucket.
  • bucketName (TEXT, Optional): Name of the bucket to move the task to. Used as an alternative to bucket id. Leave empty to keep the current bucket.
  • assignedToUserIds (ID, Optional): User ids to assign the task to. Supports comma-separated values for multiple assignees. Leave empty to keep current assignments.
  • assignedToEmails (TEXT, Optional): Email addresses (UPNs) to assign the task to. Supports comma-separated values for multiple assignees. Leave empty to keep current assignments.
  • assignToMe (BOOLEAN, Optional): Assigns the task to the current user. Only applies if no other assignee is provided.
  • clearAssignments (BOOLEAN, Optional): Removes all current assignees from the task
  • startDateTime (TEXT, Optional): Start date of the task in ISO 8601 format with timezone, e.g., 2025-08-01T09:00:00Z. Leave empty to keep the current start date.
  • dueDateTime (TEXT, Optional): Due date of the task in ISO 8601 format with timezone, e.g., 2025-08-13T17:00:00Z. Leave empty to keep the current due date.
  • percentComplete (SELECT, Optional): Completion status of the task. Use 0% for not started, 50% for in progress, or 100% for completed.
  • priority (SELECT, Optional): Priority level of the task. Leave empty to preserve the task’s existing priority (or 5 if no priority was set).
  • appliedCategories (TEXT, Optional): Comma-separated list of category labels to apply (category1 through category25). Replaces existing labels.
  • clearLabels (BOOLEAN, Optional): Removes all labels from the task
  • checklist (TEXT, Optional): Comma-separated list of checklist items. Replaces existing checklist unless append is enabled.
  • appendChecklist (BOOLEAN, Optional): Adds new checklist items to the existing checklist instead of replacing it
  • previewType (SELECT, Optional): Controls what content is shown on the task card in the Planner board view
  • orderHint (TEXT, Optional): Hint used to order the task within a bucket. Leave empty for automatic ordering.
Output: Returns the operation result

​
List buckets

microsoft_planner.list_buckets
Retrieve all buckets from a Planner plan Requires Confirmation: No Parameters:
  • planId (ID, Required): ID of the plan to get buckets from
Output: Returns the operation result

​
Create bucket

microsoft_planner.create_bucket
Create a new bucket in a Planner plan for organizing tasks Requires Confirmation: No Parameters:
  • planId (ID, Required): ID of the plan where the bucket will be created
  • name (TEXT, Required): Name of the new bucket
Output: Returns the operation result

​
Get task comments

microsoft_planner.get_task_comments
Retrieve all comments from a Planner task’s conversation thread Requires Confirmation: No Parameters:
  • taskId (ID, Required): ID of the task to get comments from
  • includeEmpty (BOOLEAN, Optional): Include comments that have no text content (system messages, etc.)
Output: Returns the operation result

​
Delete task

microsoft_planner.delete_task
Permanently delete a task from Planner Requires Confirmation: Yes Parameters:
  • taskId (ID, Required): ID of the Planner task to delete
Output: Returns the operation result

​
Add task comment

microsoft_planner.add_task_comment
Add a comment to a Planner task’s conversation thread Requires Confirmation: No Parameters:
  • taskId (ID, Required): ID of the Planner task to comment on
  • comment (TEXT, Required): The comment text to add to the task
Output: Returns the operation result

​
Triggers

​
New task

microsoft_planner.new_task
Triggers when a new task is created in a specified plan Parameters:
  • planId (TEXT, Required): ID of the plan to monitor for new tasks
  • filterByAssigneeEmail (TEXT, Optional): Only trigger for tasks assigned to this email address (UPN). Leave empty to monitor all tasks.
Output: Returns the operation result

​
Task completed

microsoft_planner.task_completed
Triggers when a task is marked as completed (100% progress) in a specified plan Parameters:
  • planId (TEXT, Required): ID of the plan to monitor for completed tasks
  • filterByAssigneeEmail (TEXT, Optional): Only trigger for tasks assigned to this email address (UPN). Leave empty to monitor all tasks.
Output: Returns the operation result