Skip to main content
Glama
Microsoft 365 MCP Server

Microsoft 365 MCP Server

by Softeria

create-planner-plan

create-planner-plan
Destructive

Create a new Microsoft Planner plan for a group or team by specifying the container URL and title; returns the new plan ID.

Instructions

Create a new plannerPlan object.

💡 TIP: Body: {"container": {"url": "https://graph.microsoft.com/v1.0/groups/{group-id}"}, "title": "..."}. For a team, the group id is the team id. The signed-in user must be a member of the group. The container cannot be changed later. Returns the new plan id; to show the plan in a channel, add a Planner tab with create-channel-tab.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "body": "<body>"
    },
    "name": "create-planner-plan"
  }
}

Input Schema

NameRequiredDescriptionDefault
bodyYes
confirmNoFor destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data.
includeHeadersNoInclude response headers (including ETag) in the response metadata
excludeResponseNoExclude the full response body and only return success or failure indication

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed84 schema fields changedv0.176.1
    • removedInput schema / $defs / def0 / properties / activeChecklistItemCount
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Number of checklist items with value set to false, representing incomplete items.",
      -      "maximum": 2147483647,
      -      "minimum": -2147483648,
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Number of checklist items with value set to false, representing incomplete items."
      -}
    • addedInput schema / $defs / def0 / properties / application
      Added value: +{
      +  "$ref": "#/$defs/def1"
      +}
    • removedInput schema / $defs / def0 / properties / appliedCategories
      Removed value: -{
      -  "additionalProperties": true,
      -  "properties": {},
      -  "type": "object"
      -}
    • removedInput schema / $defs / def0 / properties / assignedToTaskBoardFormat
      Removed value: -{
      -  "additionalProperties": true,
      -  "properties": {
      -    "id": {
      -      "description": "The unique identifier for an entity. Read-only.",
      -      "type": "string"
      -    },
      -    "orderHintsByAssignee": {
      -      "additionalProperties": true,
      -      "properties": {},
      -      "type": "object"
      -    },
      -    "unassignedOrderHint": {
      -      "description": "Hint value used to order the task on the AssignedTo view of the Task Board when the task isn't assigned to anyone, or if the orderHintsByAssignee dictionary doesn't provide an order hint for the user the task is assigned to. The format is defined as outlined here.",
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": "object"
      -}
    • removedInput schema / $defs / def0 / properties / assigneePriority
      Removed value: -{
      -  "description": "Hint used to order items of this type in a list view. The format is defined as outlined here.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedInput schema / $defs / def0 / properties / assignments
      Removed value: -{
      -  "additionalProperties": true,
      -  "properties": {},
      -  "type": "object"
      -}
    • removedInput schema / $defs / def0 / properties / bucketId
      Removed value: -{
      -  "description": "Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It's 28 characters long and case-sensitive. Format validation is done on the service.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedInput schema / $defs / def0 / properties / bucketTaskBoardFormat
      Removed value: -{
      -  "additionalProperties": true,
      -  "properties": {
      -    "id": {
      -      "description": "The unique identifier for an entity. Read-only.",
      -      "type": "string"
      -    },
      -    "orderHint": {
      -      "description": "Hint used to order tasks in the bucket view of the task board. For details about the supported format, see Using order hints in Planner.",
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": "object"
      -}
    • removedInput schema / $defs / def0 / properties / checklistItemCount
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Number of checklist items that are present on the task.",
      -      "maximum": 2147483647,
      -      "minimum": -2147483648,
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Number of checklist items that are present on the task."
      -}
    • removedInput schema / $defs / def0 / properties / completedBy
      Removed value: -{
      -  "$ref": "#/$defs/def2"
      -}
    • removedInput schema / $defs / def0 / properties / completedDateTime
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      -      "format": "date-time",
      -      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z"
      -}
    • removedInput schema / $defs / def0 / properties / conversationThreadId
      Removed value: -{
      -  "description": "Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedInput schema / $defs / def0 / properties / createdBy
      Removed value: -{
      -  "$ref": "#/$defs/def2"
      -}
    • removedInput schema / $defs / def0 / properties / createdDateTime
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      -      "format": "date-time",
      -      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z"
      -}
    • removedInput schema / $defs / def0 / properties / details
      Removed value: -{
      -  "additionalProperties": true,
      -  "properties": {
      -    "checklist": {
      -      "additionalProperties": true,
      -      "properties": {},
      -      "type": "object"
      -    },
      -    "description": {
      -      "description": "Description of the task.",
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "id": {
      -      "description": "The unique identifier for an entity. Read-only.",
      -      "type": "string"
      -    },
      -    "previewType": {
      -      "$ref": "#/$defs/def1"
      -    },
      -    "references": {
      -      "additionalProperties": true,
      -      "properties": {},
      -      "type": "object"
      -    }
      -  },
      -  "type": "object"
      -}
    • addedInput schema / $defs / def0 / properties / device
      Added value: +{
      +  "$ref": "#/$defs/def1"
      +}
    • removedInput schema / $defs / def0 / properties / dueDateTime
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      -      "format": "date-time",
      -      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z"
      -}
    • removedInput schema / $defs / def0 / properties / hasDescription
      Removed value: -{
      -  "description": "Read-only. Value is true if the details object of the task has a nonempty description and false otherwise.",
      -  "type": [
      -    "boolean",
      -    "null"
      -  ]
      -}
    • removedInput schema / $defs / def0 / properties / id
      Removed value: -{
      -  "description": "The unique identifier for an entity. Read-only.",
      -  "type": "string"
      -}
    • removedInput schema / $defs / def0 / properties / orderHint
      Removed value: -{
      -  "description": "Hint used to order items of this type in a list view. The format is defined as outlined here.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedInput schema / $defs / def0 / properties / percentComplete
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Percentage of task completion. When set to 100, the task is considered completed.",
      -      "maximum": 2147483647,
      -      "minimum": -2147483648,
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Percentage of task completion. When set to 100, the task is considered completed."
      -}
    • removedInput schema / $defs / def0 / properties / planId
      Removed value: -{
      -  "description": "Plan ID to which the task belongs.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedInput schema / $defs / def0 / properties / previewType
      Removed value: -{
      -  "$ref": "#/$defs/def1"
      -}
    • removedInput schema / $defs / def0 / properties / priority
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Priority of the task. The valid range of values is between 0 and 10, with the increasing value being lower priority (0 has the highest priority and 10 has the lowest priority).  Currently, Planner interprets values 0 and 1 as 'urgent', 2, 3 and 4 as 'important', 5, 6, and 7 as 'medium', and 8, 9, and 10 as 'low'.  Additionally, Planner sets the value 1 for 'urgent', 3 for 'important', 5 for 'medium', and 9 for 'low'.",
      -      "maximum": 2147483647,
      -      "minimum": -2147483648,
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Priority of the task. The valid range of values is between 0 and 10, with the increasing value being lower priority (0 has the highest priority and 10 has the lowest priority).  Currently, Planner interprets values 0 and 1 as 'urgent', 2, 3 and 4 as 'important', 5, 6, and 7 as 'medium', and 8, 9, and 10 as 'low'.  Additionally, Planner sets the value 1 for 'urgent', 3 for 'important', 5 for 'medium', and 9 for 'low'."
      -}
    • removedInput schema / $defs / def0 / properties / referenceCount
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Number of external references that exist on the task.",
      -      "maximum": 2147483647,
      -      "minimum": -2147483648,
      -      "type": "number"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Number of external references that exist on the task."
      -}
    • removedInput schema / $defs / def0 / properties / startDateTime
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "description": "Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      -      "format": "date-time",
      -      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      -      "type": "string"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ],
      -  "description": "Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z"
      -}
    • removedInput schema / $defs / def0 / properties / title
      Removed value: -{
      -  "description": "Title of the task.",
      -  "type": "string"
      -}
    • addedInput schema / $defs / def0 / properties / user
      Added value: +{
      +  "$ref": "#/$defs/def1"
      +}
    • addedInput schema / $defs / def1 / additionalProperties
      Added value: +true
    • removedInput schema / $defs / def1 / enum
      Removed value: -[
      -  "automatic",
      -  "noPreview",
      -  "checklist",
      -  "description",
      -  "reference"
      -]
    • addedInput schema / $defs / def1 / properties
      Added value: +{
      +  "displayName": {
      +    "description": "The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.",
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  },
      +  "id": {
      +    "description": "Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review.",
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  }
      +}
    • changedInput schema / $defs / def1 / type
      Previous value: -"string"New value: +"object"
    • removedInput schema / $defs / def2 / properties / application
      Removed value: -{
      -  "$ref": "#/$defs/def3"
      -}
    • removedInput schema / $defs / def2 / properties / device
      Removed value: -{
      -  "$ref": "#/$defs/def3"
      -}
    • addedInput schema / $defs / def2 / properties / id
      Added value: +{
      +  "description": "The unique identifier for an entity. Read-only.",
      +  "type": "string"
      +}
    • addedInput schema / $defs / def2 / properties / name
      Added value: +{
      +  "description": "Name of the bucket.",
      +  "type": "string"
      +}
    • addedInput schema / $defs / def2 / properties / orderHint
      Added value: +{
      +  "description": "Hint used to order items of this type in a list view. For details about the supported format, see Using order hints in Planner.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / $defs / def2 / properties / planId
      Added value: +{
      +  "description": "Plan ID to which the bucket belongs.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / $defs / def2 / properties / tasks
      Added value: +{
      +  "description": "Read-only. Nullable. The collection of tasks in the bucket.",
      +  "items": {
      +    "$ref": "#/$defs/def3"
      +  },
      +  "type": "array"
      +}
    • removedInput schema / $defs / def2 / properties / user
      Removed value: -{
      -  "$ref": "#/$defs/def3"
      -}
    • addedInput schema / $defs / def3 / properties / activeChecklistItemCount
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Number of checklist items with value set to false, representing incomplete items.",
      +      "maximum": 2147483647,
      +      "minimum": -2147483648,
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / appliedCategories
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {},
      +  "type": "object"
      +}
    • addedInput schema / $defs / def3 / properties / assignedToTaskBoardFormat
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "id": {
      +      "description": "The unique identifier for an entity. Read-only.",
      +      "type": "string"
      +    },
      +    "orderHintsByAssignee": {
      +      "additionalProperties": true,
      +      "properties": {},
      +      "type": "object"
      +    },
      +    "unassignedOrderHint": {
      +      "description": "Hint value used to order the task on the AssignedTo view of the Task Board when the task isn't assigned to anyone, or if the orderHintsByAssignee dictionary doesn't provide an order hint for the user the task is assigned to. The format is defined as outlined here.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / $defs / def3 / properties / assigneePriority
      Added value: +{
      +  "description": "Hint used to order items of this type in a list view. The format is defined as outlined here.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / assignments
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {},
      +  "type": "object"
      +}
    • addedInput schema / $defs / def3 / properties / bucketId
      Added value: +{
      +  "description": "Bucket ID to which the task belongs. The bucket needs to be in the plan that the task is in. It's 28 characters long and case-sensitive. Format validation is done on the service.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / bucketTaskBoardFormat
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "id": {
      +      "description": "The unique identifier for an entity. Read-only.",
      +      "type": "string"
      +    },
      +    "orderHint": {
      +      "description": "Hint used to order tasks in the bucket view of the task board. For details about the supported format, see Using order hints in Planner.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / $defs / def3 / properties / checklistItemCount
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Number of checklist items that are present on the task.",
      +      "maximum": 2147483647,
      +      "minimum": -2147483648,
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / completedBy
      Added value: +{
      +  "$ref": "#/$defs/def0"
      +}
    • addedInput schema / $defs / def3 / properties / completedDateTime
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Read-only. Date and time at which the 'percentComplete' of the task is set to '100'. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      +      "format": "date-time",
      +      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / conversationThreadId
      Added value: +{
      +  "description": "Thread ID of the conversation on the task. This is the ID of the conversation thread object created in the group.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / createdBy
      Added value: +{
      +  "$ref": "#/$defs/def0"
      +}
    • addedInput schema / $defs / def3 / properties / createdDateTime
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Read-only. Date and time at which the task is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      +      "format": "date-time",
      +      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / details
      Added value: +{
      +  "additionalProperties": true,
      +  "properties": {
      +    "checklist": {
      +      "additionalProperties": true,
      +      "properties": {},
      +      "type": "object"
      +    },
      +    "description": {
      +      "description": "Description of the task.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "id": {
      +      "description": "The unique identifier for an entity. Read-only.",
      +      "type": "string"
      +    },
      +    "previewType": {
      +      "$ref": "#/$defs/def4"
      +    },
      +    "references": {
      +      "additionalProperties": true,
      +      "properties": {},
      +      "type": "object"
      +    }
      +  },
      +  "type": "object"
      +}
    • removedInput schema / $defs / def3 / properties / displayName
      Removed value: -{
      -  "description": "The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta.",
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • addedInput schema / $defs / def3 / properties / dueDateTime
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Date and time at which the task is due. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      +      "format": "date-time",
      +      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / hasDescription
      Added value: +{
      +  "description": "Read-only. Value is true if the details object of the task has a nonempty description and false otherwise.",
      +  "type": [
      +    "boolean",
      +    "null"
      +  ]
      +}
    • changedInput schema / $defs / def3 / properties / id / description
      Previous value: -"Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review."New value: +"The unique identifier for an entity. Read-only."
    • changedInput schema / $defs / def3 / properties / id / type
      Previous value: -[
      -  "string",
      -  "null"
      -]New value: +"string"
    • addedInput schema / $defs / def3 / properties / orderHint
      Added value: +{
      +  "description": "Hint used to order items of this type in a list view. The format is defined as outlined here.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / percentComplete
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Percentage of task completion. When set to 100, the task is considered completed.",
      +      "maximum": 2147483647,
      +      "minimum": -2147483648,
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / planId
      Added value: +{
      +  "description": "Plan ID to which the task belongs.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / previewType
      Added value: +{
      +  "$ref": "#/$defs/def4"
      +}
    • addedInput schema / $defs / def3 / properties / priority
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Priority of the task. The valid range of values is between 0 and 10, with the increasing value being lower priority (0 has the highest priority and 10 has the lowest priority).  Currently, Planner interprets values 0 and 1 as 'urgent', 2, 3 and 4 as 'important', 5, 6, and 7 as 'medium', and 8, 9, and 10 as 'low'.  Additionally, Planner sets the value 1 for 'urgent', 3 for 'important', 5 for 'medium', and 9 for 'low'.",
      +      "maximum": 2147483647,
      +      "minimum": -2147483648,
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / referenceCount
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Number of external references that exist on the task.",
      +      "maximum": 2147483647,
      +      "minimum": -2147483648,
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / startDateTime
      Added value: +{
      +  "anyOf": [
      +    {
      +      "description": "Date and time at which the task starts. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z",
      +      "format": "date-time",
      +      "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ]
      +}
    • addedInput schema / $defs / def3 / properties / title
      Added value: +{
      +  "description": "Title of the task.",
      +  "type": "string"
      +}
    • addedInput schema / $defs / def4
      Added value: +{
      +  "enum": [
      +    "automatic",
      +    "noPreview",
      +    "checklist",
      +    "description",
      +    "reference"
      +  ],
      +  "type": "string"
      +}
    • addedInput schema / $defs / def5
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / $defs / def6
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / $defs / def7
      Added value: +{
      +  "type": "boolean"
      +}
    • addedInput schema / properties / body / properties / buckets / items / $ref
      Added value: +"#/$defs/def2"
    • removedInput schema / properties / body / properties / buckets / items / additionalProperties
      Removed value: -true
    • removedInput schema / properties / body / properties / buckets / items / properties
      Removed value: -{
      -  "id": {
      -    "description": "The unique identifier for an entity. Read-only.",
      -    "type": "string"
      -  },
      -  "name": {
      -    "description": "Name of the bucket.",
      -    "type": "string"
      -  },
      -  "orderHint": {
      -    "description": "Hint used to order items of this type in a list view. For details about the supported format, see Using order hints in Planner.",
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "planId": {
      -    "description": "Plan ID to which the bucket belongs.",
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "tasks": {
      -    "description": "Read-only. Nullable. The collection of tasks in the bucket.",
      -    "items": {
      -      "$ref": "#/$defs/def0"
      -    },
      -    "type": "array"
      -  }
      -}
    • removedInput schema / properties / body / properties / buckets / items / type
      Removed value: -"object"
    • changedInput schema / properties / body / properties / createdBy / $ref
      Previous value: -"#/$defs/def2"New value: +"#/$defs/def0"
    • removedInput schema / properties / body / properties / createdDateTime / description
      Removed value: -"Read-only. Date and time at which the plan is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z"
    • changedInput schema / properties / body / properties / tasks / items / $ref
      Previous value: -"#/$defs/def0"New value: +"#/$defs/def3"
    • addedInput schema / properties / confirm / allOf
      Added value: +[
      +  {
      +    "$ref": "#/$defs/def5"
      +  }
      +]
    • removedInput schema / properties / confirm / type
      Removed value: -"boolean"
    • addedInput schema / properties / excludeResponse / allOf
      Added value: +[
      +  {
      +    "$ref": "#/$defs/def6"
      +  }
      +]
    • removedInput schema / properties / excludeResponse / type
      Removed value: -"boolean"
    • addedInput schema / properties / includeHeaders / allOf
      Added value: +[
      +  {
      +    "$ref": "#/$defs/def7"
      +  }
      +]
    • removedInput schema / properties / includeHeaders / type
      Removed value: -"boolean"
  2. Addedv0.171.0

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag destructiveHint=true and openWorldHint=true, so the agent knows it is a state-changing operation. The description adds crucial context: group membership requirement, container immutability, and that it returns the new plan id. It does not explain why destructiveHint is true, but does not contradict it.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loads the action, then a compact tip with body example and key constraints. No wasted sentences; each adds actionable detail.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a nested create operation with no output schema, the description covers how to structure the body, auth prerequisite, immutability, and return value. It omits the confirm gate but the schema handles it.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 75%, so most parameters are documented. The description adds a concrete body example showing the minimal required container.url and title, plus the team/group id mapping, which goes beyond schema. It does not cover confirm/includeHeaders/excludeResponse, but those have schema descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb 'Create' and resource 'plannerPlan object', and the body example clarifies what a plan consists of. This distinguishes it from update-planner-plan and get-planner-plan.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear preconditions: signed-in user must be a member of the group, and the container cannot be changed later. It mentions an alternative follow-up action (create-channel-tab) to show the plan in a channel, but does not explicitly compare with update-planner-plan.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools