Skip to main content

Microsoft Planner

Manage plans, tasks, and buckets in Microsoft Planner, and personal lists, tasks, and steps in Microsoft To Do, through the Microsoft Graph API.

What you can ask​

  • List all tasks assigned to me across every plan that are past their due date.
  • Create a task in the Sprint 42 bucket and assign it to a team member.
  • Show the completion status of all tasks in a given plan, grouped by bucket.

Set up​

Microsoft Planner needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Microsoft Planner. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Microsoft Planner developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Microsoft Planner login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (4)

Grant the scopes for the tools you plan to allow.

  • GroupMember.Read.All
  • Tasks.Read
  • Tasks.ReadWrite
  • User.Read

Tools​

Microsoft Planner offers 43 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (18)​

View and search information without changing it.

ToolWhat it does
get_bucketGet a Planner bucket by ID.
get_planGet a Planner plan by ID.
get_plan_detailsGet extended details for a Planner plan including shared users and category label names.
get_taskGet a Planner task by ID.
get_task_detailsGet extended task details including description, checklist items, and external references.
get_todo_listGet a Microsoft To Do list by ID.
get_todo_stepGet a single checklist step from a Microsoft To Do task.
get_todo_taskGet a Microsoft To Do task by ID.
list_bucketsList all buckets in a Planner plan.
list_checklist_itemsList all checklist items (sub-steps) on a Planner task.
list_group_membersList the users in a Microsoft 365 group, with their user IDs.
list_groupsList the Microsoft 365 groups the signed-in user belongs to.
list_plansList Planner plans.
list_tasksList Planner tasks.
list_todo_listsList all Microsoft To Do lists for the current user.
list_todo_stepsList the checklist steps on a Microsoft To Do task.
list_todo_tasksList tasks in a Microsoft To Do list, optionally filtered by status or importance and sorted by order_by.
validate_credentialValidate Microsoft Planner credentials by calling GET /me on Microsoft Graph.

Write (8)​

Create or send data.

ToolWhat it does
add_checklist_itemAdd a checklist item (sub-step) to a Planner task.
add_task_referenceAttach a link to a Planner task, such as a SharePoint document or a web page.
create_bucketCreate a new bucket in a Planner plan to organize tasks.
create_planCreate a Planner plan owned by a Microsoft 365 group. group_id is required and the signed-in user must be a member of that group; call list_groups first to find one.
create_taskCreate a new task in a Planner plan, optionally assigned, scheduled, prioritized or labelled.
create_todo_listCreate a new Microsoft To Do list.
create_todo_stepAdd a checklist step to a Microsoft To Do task.
create_todo_taskCreate a task in a Microsoft To Do list.

Delete or overwrite (17)​

Remove or replace existing data.

ToolWhat it does
delete_bucketPermanently delete a Planner bucket.
delete_checklist_itemDelete a checklist item from a Planner task.
delete_planPermanently delete a Planner plan and all its tasks and buckets.
delete_taskPermanently delete a Planner task.
delete_todo_listPermanently delete a Microsoft To Do list and all its tasks.
delete_todo_stepDelete a checklist step from a Microsoft To Do task.
delete_todo_taskPermanently delete a Microsoft To Do task.
remove_task_referenceRemove a link from a Planner task.
update_bucketUpdate a Planner bucket's name or order.
update_checklist_itemUpdate a checklist item's title or checked state on a Planner task.
update_planUpdate a Planner plan's title.
update_plan_detailsShare a plan with users or name its category labels.
update_taskUpdate a Planner task's title, bucket, start or due date, priority, completion percentage, assignees or category labels.
update_task_detailsUpdate a task's description, card preview, checklist items, or external references.
update_todo_listRename a Microsoft To Do list.
update_todo_stepUpdate a checklist step on a Microsoft To Do task.
update_todo_taskUpdate a Microsoft To Do task.
⌘J