Skip to main content
Glama
Microsoft 365 MCP Server

Microsoft 365 MCP Server

by Softeria

update-todo-task-list

update-todo-task-list
Destructive

Rename a Microsoft To Do task list by updating its display name; built-in lists such as the default Tasks list or Flagged emails cannot be renamed.

Instructions

Update the properties of a todoTaskList object.

šŸ’” TIP: Renames a Microsoft To Do task list. Body: { displayName: 'New name' }. Only displayName is writable. Built-in lists (Flagged emails, the default Tasks list) cannot be renamed — the API returns an error. Get list ids via list-todo-task-lists.

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>",
      "todoTaskListId": "<todoTaskListId>"
    },
    "name": "update-todo-task-list"
  }
}

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
todoTaskListIdYesValue for the 'todoTaskListId' path segment. Pass it under the name 'todoTaskListId', not as 'id'. Use the 'id' field of the todo task list object as returned by Microsoft Graph.
excludeResponseNoExclude the full response body and only return success or failure indication

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.179.1
    • addedInput schema / properties / body / properties / singleValueExtendedProperties
      Added value: +{
      +  "description": "The collection of single-value extended properties defined for the task list. Nullable.",
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "id": {
      +        "description": "The unique identifier for an entity. Read-only.",
      +        "type": "string"
      +      },
      +      "value": {
      +        "description": "The value of the property.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedInput schema / properties / body / properties / tasks / items / properties / singleValueExtendedProperties
      Added value: +{
      +  "description": "A collection of custom fields linked to the task.",
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "id": {
      +        "description": "The unique identifier for an entity. Read-only.",
      +        "type": "string"
      +      },
      +      "value": {
      +        "description": "The value of the property.",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
  2. Changed5 schema fields changedv0.176.1
    • removedInput schema / properties / body / properties / tasks / items / properties / attachmentSessions / items / properties / expirationDateTime / description
      Removed value: -"The date and time in UTC when the upload session will expire. The complete file must be uploaded before this expiration time is reached."
    • removedInput schema / properties / body / properties / tasks / items / properties / attachments / items / properties / lastModifiedDateTime / description
      Removed value: -"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 / properties / body / properties / tasks / items / properties / checklistItems / items / properties / checkedDateTime / description
      Removed value: -"The date and time when the checklistItem was finished."
    • removedInput schema / properties / body / properties / tasks / items / properties / recurrence / properties / range / properties / endDate / description
      Removed value: -"The date to stop applying the recurrence pattern. Depending on the recurrence pattern of the event, the last occurrence of the meeting may not be this date. Required if type is endDate."
    • removedInput schema / properties / body / properties / tasks / items / properties / recurrence / properties / range / properties / startDate / description
      Removed value: -"The date to start applying the recurrence pattern. The first occurrence of the meeting may be this date or later, depending on the recurrence pattern of the event. Must be the same value as the start property of the recurring event. Required."
  3. Changed29 schema fields changedv0.145.2
    • removedInput schema / $defs
      Removed value: -{
      -  "def0": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "id": {
      -        "description": "The unique identifier for an entity. Read-only.",
      -        "type": "string"
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "def1": {
      -    "additionalProperties": true,
      -    "properties": {
      -      "dateTime": {
      -        "description": "A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000).",
      -        "type": "string"
      -      },
      -      "timeZone": {
      -        "description": "Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values.",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  },
      -  "def2": {
      -    "enum": [
      -      "sunday",
      -      "monday",
      -      "tuesday",
      -      "wednesday",
      -      "thursday",
      -      "friday",
      -      "saturday"
      -    ],
      -    "type": "string"
      -  }
      -}
    • removedInput schema / properties / body / properties / extensions / items / $ref
      Removed value: -"#/$defs/def0"
    • addedInput schema / properties / body / properties / extensions / items / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / extensions / items / properties
      Added value: +{
      +  "id": {
      +    "description": "The unique identifier for an entity. Read-only.",
      +    "type": "string"
      +  }
      +}
    • addedInput schema / properties / body / properties / extensions / items / type
      Added value: +"object"
    • removedInput schema / properties / body / properties / tasks / items / properties / completedDateTime / $ref
      Removed value: -"#/$defs/def1"
    • addedInput schema / properties / body / properties / tasks / items / properties / completedDateTime / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / tasks / items / properties / completedDateTime / properties
      Added value: +{
      +  "dateTime": {
      +    "description": "A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000).",
      +    "type": "string"
      +  },
      +  "timeZone": {
      +    "description": "Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values.",
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  }
      +}
    • addedInput schema / properties / body / properties / tasks / items / properties / completedDateTime / type
      Added value: +"object"
    • removedInput schema / properties / body / properties / tasks / items / properties / dueDateTime / $ref
      Removed value: -"#/$defs/def1"
    • addedInput schema / properties / body / properties / tasks / items / properties / dueDateTime / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / tasks / items / properties / dueDateTime / properties
      Added value: +{
      +  "dateTime": {
      +    "description": "A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000).",
      +    "type": "string"
      +  },
      +  "timeZone": {
      +    "description": "Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values.",
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  }
      +}
    • addedInput schema / properties / body / properties / tasks / items / properties / dueDateTime / type
      Added value: +"object"
    • removedInput schema / properties / body / properties / tasks / items / properties / extensions / items / $ref
      Removed value: -"#/$defs/def0"
    • addedInput schema / properties / body / properties / tasks / items / properties / extensions / items / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / tasks / items / properties / extensions / items / properties
      Added value: +{
      +  "id": {
      +    "description": "The unique identifier for an entity. Read-only.",
      +    "type": "string"
      +  }
      +}
    • addedInput schema / properties / body / properties / tasks / items / properties / extensions / items / type
      Added value: +"object"
    • changedInput schema / properties / body / properties / tasks / items / properties / recurrence / properties / pattern / properties / daysOfWeek / items / anyOf
      Previous value: -[
      -  {
      -    "$ref": "#/$defs/def2"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {},
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "enum": [
      +      "sunday",
      +      "monday",
      +      "tuesday",
      +      "wednesday",
      +      "thursday",
      +      "friday",
      +      "saturday"
      +    ],
      +    "type": "string"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {},
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / body / properties / tasks / items / properties / recurrence / properties / pattern / properties / firstDayOfWeek / $ref
      Removed value: -"#/$defs/def2"
    • addedInput schema / properties / body / properties / tasks / items / properties / recurrence / properties / pattern / properties / firstDayOfWeek / enum
      Added value: +[
      +  "sunday",
      +  "monday",
      +  "tuesday",
      +  "wednesday",
      +  "thursday",
      +  "friday",
      +  "saturday"
      +]
    • addedInput schema / properties / body / properties / tasks / items / properties / recurrence / properties / pattern / properties / firstDayOfWeek / type
      Added value: +"string"
    • removedInput schema / properties / body / properties / tasks / items / properties / reminderDateTime / $ref
      Removed value: -"#/$defs/def1"
    • addedInput schema / properties / body / properties / tasks / items / properties / reminderDateTime / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / tasks / items / properties / reminderDateTime / properties
      Added value: +{
      +  "dateTime": {
      +    "description": "A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000).",
      +    "type": "string"
      +  },
      +  "timeZone": {
      +    "description": "Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values.",
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  }
      +}
    • addedInput schema / properties / body / properties / tasks / items / properties / reminderDateTime / type
      Added value: +"object"
    • removedInput schema / properties / body / properties / tasks / items / properties / startDateTime / $ref
      Removed value: -"#/$defs/def1"
    • addedInput schema / properties / body / properties / tasks / items / properties / startDateTime / additionalProperties
      Added value: +true
    • addedInput schema / properties / body / properties / tasks / items / properties / startDateTime / properties
      Added value: +{
      +  "dateTime": {
      +    "description": "A single point of time in a combined date and time representation ({date}T{time}; for example, 2017-08-29T04:00:00.0000000).",
      +    "type": "string"
      +  },
      +  "timeZone": {
      +    "description": "Represents a time zone, for example, 'Pacific Standard Time'. See below for more possible values.",
      +    "type": [
      +      "string",
      +      "null"
      +    ]
      +  }
      +}
    • addedInput schema / properties / body / properties / tasks / items / properties / startDateTime / type
      Added value: +"object"
  4. Addedv0.135.0
  5. Removedv0.134.4
  6. Changed1 schema field changedv0.131.2
    • changedInput schema / additionalProperties
      Previous value: -falseNew value: +true
  7. Changed1 schema field changedv0.131.1
    • addedInput schema / properties / confirm
      Added value: +{
      +  "description": "For 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.",
      +  "type": "boolean"
      +}
  8. Addedv0.114.0
  9. Removedv0.112.2
  10. Addedv0.110.0
  11. Removedv0.108.0
  12. Addedv0.105.0

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare destructiveHint=true and openWorldHint=true, so the mutation profile is covered structurally; the description adds real value beyond that by disclosing that only displayName is writable and that built-in lists fail server-side. It does not say whether the update is a full replace or a partial patch, or what a failure response looks like, which keeps it off a 5.

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

Conciseness4/5

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

Front-loaded with the operation, then the practical constraint and id source in one compact TIP block. The opening sentence is slightly redundant against the following tip, but nothing else is filler.

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

Completeness5/5

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

For a nested-body mutation with no output schema, the definition covers the decisive facts an agent needs: which field actually changes, where the id comes from, and which lists reject the call. The bloated body schema is effectively neutralized by the description, leaving no practical gap before invocation.

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 80% so the baseline is 3, but the description earns more: it supplies the literal body payload shape ({ displayName: 'New name' }), constrains the otherwise sprawling body object to a single meaningful field, and points at list-todo-task-lists as the source of todoTaskListId, which the schema description only partly conveys.

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 and resource ('Update the properties of a todoTaskList object') and then narrows it to the actual effective operation ('Renames a Microsoft To Do task list ... Only displayName is writable'), which distinguishes it from create-todo-task-list, delete-todo-task-list and list-todo-task-lists without opening any schema.

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 a concrete precondition and routing hint ('Get list ids via list-todo-task-lists') plus an explicit when-not ('Built-in lists (Flagged emails, the default Tasks list) cannot be renamed — the API returns an error'). It does not compare against update-todo-task, but the list-level vs task-level split is clear from the names.

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