Sim

Microsoft Planner

Manage tasks, plans, and buckets in Microsoft Planner

Microsoft Planner is a task management tool that helps teams organize work visually using boards, tasks, and buckets. Integrated with Microsoft 365, it offers a simple, intuitive way to manage team projects, assign responsibilities, and track progress.

With Microsoft Planner, you can:

  • Create and manage tasks: Add new tasks with due dates, priorities, and assigned users
  • Organize with buckets: Group tasks by phase, status, or category to reflect your team’s workflow
  • Visualize project status: Use boards, charts, and filters to monitor workload and track progress
  • Stay integrated with Microsoft 365: Seamlessly connect tasks with Teams, Outlook, and other Microsoft tools

In Sim, the Microsoft Planner integration allows your agents to programmatically create, read, and manage tasks as part of their workflows. Agents can generate new tasks based on incoming requests, retrieve task details to drive decisions, and track status across projects — all without human intervention. Whether you're building workflows for client onboarding, internal project tracking, or follow-up task generation, integrating Microsoft Planner with Sim gives your agents a structured way to coordinate work, automate task creation, and keep teams aligned.

Usage Instructions

Integrate Microsoft Planner into the workflow. Manage tasks, plans, buckets, and task details including checklists and references.

Tools

microsoft_planner_read_task

Read tasks from Microsoft Planner - get all user tasks or all tasks from a specific plan

Input

ParameterTypeRequiredDescription
planIdstringNoThe ID of the plan to get tasks from (if not provided, gets all user tasks)
taskIdstringNoThe ID of the task to get

Output

ParameterTypeDescription
successbooleanWhether tasks were retrieved successfully
tasksarrayArray of task objects with filtered properties
metadataobjectMetadata including planId, userId, and planUrl

microsoft_planner_create_task

Create a new task in Microsoft Planner

Input

ParameterTypeRequiredDescription
planIdstringYesThe ID of the plan where the task will be created
titlestringYesThe title of the task
descriptionstringNoThe description of the task
dueDateTimestringNoThe due date and time for the task (ISO 8601 format)
assigneeUserIdstringNoThe user ID to assign the task to
bucketIdstringNoThe bucket ID to place the task in

Output

ParameterTypeDescription
successbooleanWhether the task was created successfully
taskobjectThe created task object with all properties
metadataobjectMetadata including planId, taskId, and taskUrl

microsoft_planner_update_task

Update a task in Microsoft Planner

Input

ParameterTypeRequiredDescription
taskIdstringYesThe ID of the task to update
etagstringYesThe ETag value from the task to update (If-Match header)
titlestringNoThe new title of the task
bucketIdstringNoThe bucket ID to move the task to
dueDateTimestringNoThe due date and time for the task (ISO 8601 format)
startDateTimestringNoThe start date and time for the task (ISO 8601 format)
percentCompletenumberNoThe percentage of task completion (0-100)
prioritynumberNoThe priority of the task (0-10)
assigneeUserIdstringNoThe user ID to assign the task to

Output

ParameterTypeDescription
successbooleanWhether the task was updated successfully
messagestringSuccess message when task is updated
taskobjectThe updated task object with all properties
taskIdstringID of the updated task
etagstringNew ETag after update - use this for subsequent operations
metadataobjectMetadata including taskId, planId, and taskUrl

microsoft_planner_delete_task

Delete a task from Microsoft Planner

Input

ParameterTypeRequiredDescription
taskIdstringYesThe ID of the task to delete
etagstringYesThe ETag value from the task to delete (If-Match header)

Output

ParameterTypeDescription
successbooleanWhether the task was deleted successfully
deletedbooleanConfirmation of deletion
metadataobjectAdditional metadata

microsoft_planner_list_plans

List all plans shared with the current user

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
successbooleanWhether plans were retrieved successfully
plansarrayArray of plan objects shared with the current user
metadataobjectMetadata including userId and count

microsoft_planner_read_plan

Get details of a specific Microsoft Planner plan

Input

ParameterTypeRequiredDescription
planIdstringYesThe ID of the plan to retrieve

Output

ParameterTypeDescription
successbooleanWhether the plan was retrieved successfully
planobjectThe plan object with all properties
metadataobjectMetadata including planId and planUrl

microsoft_planner_list_buckets

List all buckets in a Microsoft Planner plan

Input

ParameterTypeRequiredDescription
planIdstringYesThe ID of the plan

Output

ParameterTypeDescription
successbooleanWhether buckets were retrieved successfully
bucketsarrayArray of bucket objects
metadataobjectMetadata including planId and count

microsoft_planner_read_bucket

Get details of a specific bucket

Input

ParameterTypeRequiredDescription
bucketIdstringYesThe ID of the bucket to retrieve

Output

ParameterTypeDescription
successbooleanWhether the bucket was retrieved successfully
bucketobjectThe bucket object with all properties
metadataobjectMetadata including bucketId and planId

microsoft_planner_create_bucket

Create a new bucket in a Microsoft Planner plan

Input

ParameterTypeRequiredDescription
planIdstringYesThe ID of the plan where the bucket will be created
namestringYesThe name of the bucket

Output

ParameterTypeDescription
successbooleanWhether the bucket was created successfully
bucketobjectThe created bucket object with all properties
metadataobjectMetadata including bucketId and planId

microsoft_planner_update_bucket

Update a bucket in Microsoft Planner

Input

ParameterTypeRequiredDescription
bucketIdstringYesThe ID of the bucket to update
namestringNoThe new name of the bucket
etagstringYesThe ETag value from the bucket to update (If-Match header)

Output

ParameterTypeDescription
successbooleanWhether the bucket was updated successfully
bucketobjectThe updated bucket object with all properties
metadataobjectMetadata including bucketId and planId

microsoft_planner_delete_bucket

Delete a bucket from Microsoft Planner

Input

ParameterTypeRequiredDescription
bucketIdstringYesThe ID of the bucket to delete
etagstringYesThe ETag value from the bucket to delete (If-Match header)

Output

ParameterTypeDescription
successbooleanWhether the bucket was deleted successfully
deletedbooleanConfirmation of deletion
metadataobjectAdditional metadata

microsoft_planner_get_task_details

Get detailed information about a task including checklist and references

Input

ParameterTypeRequiredDescription
taskIdstringYesThe ID of the task

Output

ParameterTypeDescription
successbooleanWhether the task details were retrieved successfully
taskDetailsobjectThe task details including description, checklist, and references
etagstringThe ETag value for this task details - use this for update operations
metadataobjectMetadata including taskId

microsoft_planner_update_task_details

Update task details including description, checklist items, and references in Microsoft Planner

Input

ParameterTypeRequiredDescription
taskIdstringYesThe ID of the task
etagstringYesThe ETag value from the task details to update (If-Match header)
descriptionstringNoThe description of the task
checklistobjectNoChecklist items as a JSON object
referencesobjectNoReferences as a JSON object
previewTypestringNoPreview type: automatic, noPreview, checklist, description, or reference

Output

ParameterTypeDescription
successbooleanWhether the task details were updated successfully
taskDetailsobjectThe updated task details object with all properties
metadataobjectMetadata including taskId

Notes

  • Category: tools
  • Type: microsoft_planner