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 42bucket 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.
- Go to Organization > Connectors and find Microsoft Planner. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Microsoft Planner developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- 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.AllTasks.ReadTasks.ReadWriteUser.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.
| Tool | What it does |
|---|---|
get_bucket | Get a Planner bucket by ID. |
get_plan | Get a Planner plan by ID. |
get_plan_details | Get extended details for a Planner plan including shared users and category label names. |
get_task | Get a Planner task by ID. |
get_task_details | Get extended task details including description, checklist items, and external references. |
get_todo_list | Get a Microsoft To Do list by ID. |
get_todo_step | Get a single checklist step from a Microsoft To Do task. |
get_todo_task | Get a Microsoft To Do task by ID. |
list_buckets | List all buckets in a Planner plan. |
list_checklist_items | List all checklist items (sub-steps) on a Planner task. |
list_group_members | List the users in a Microsoft 365 group, with their user IDs. |
list_groups | List the Microsoft 365 groups the signed-in user belongs to. |
list_plans | List Planner plans. |
list_tasks | List Planner tasks. |
list_todo_lists | List all Microsoft To Do lists for the current user. |
list_todo_steps | List the checklist steps on a Microsoft To Do task. |
list_todo_tasks | List tasks in a Microsoft To Do list, optionally filtered by status or importance and sorted by order_by. |
validate_credential | Validate Microsoft Planner credentials by calling GET /me on Microsoft Graph. |
Write (8)
Create or send data.
| Tool | What it does |
|---|---|
add_checklist_item | Add a checklist item (sub-step) to a Planner task. |
add_task_reference | Attach a link to a Planner task, such as a SharePoint document or a web page. |
create_bucket | Create a new bucket in a Planner plan to organize tasks. |
create_plan | Create 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_task | Create a new task in a Planner plan, optionally assigned, scheduled, prioritized or labelled. |
create_todo_list | Create a new Microsoft To Do list. |
create_todo_step | Add a checklist step to a Microsoft To Do task. |
create_todo_task | Create a task in a Microsoft To Do list. |
Delete or overwrite (17)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_bucket | Permanently delete a Planner bucket. |
delete_checklist_item | Delete a checklist item from a Planner task. |
delete_plan | Permanently delete a Planner plan and all its tasks and buckets. |
delete_task | Permanently delete a Planner task. |
delete_todo_list | Permanently delete a Microsoft To Do list and all its tasks. |
delete_todo_step | Delete a checklist step from a Microsoft To Do task. |
delete_todo_task | Permanently delete a Microsoft To Do task. |
remove_task_reference | Remove a link from a Planner task. |
update_bucket | Update a Planner bucket's name or order. |
update_checklist_item | Update a checklist item's title or checked state on a Planner task. |
update_plan | Update a Planner plan's title. |
update_plan_details | Share a plan with users or name its category labels. |
update_task | Update a Planner task's title, bucket, start or due date, priority, completion percentage, assignees or category labels. |
update_task_details | Update a task's description, card preview, checklist items, or external references. |
update_todo_list | Rename a Microsoft To Do list. |
update_todo_step | Update a checklist step on a Microsoft To Do task. |
update_todo_task | Update a Microsoft To Do task. |