> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Microsoft To Do

The Microsoft To Do connector lets your AI agent act in each user's Microsoft To Do account. Each user signs in to Microsoft To Do once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 23 tools.

**Authentication:** OAuth 2.0
**Categories:** Productivity, Project Management
**Tools:** 23: 10 read, 8 write, 5 destructive
**Users sign in with:** OAuth
**OAuth app:** Scalekit's or your own
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=MICROSOFTTODO)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Microsoft To Do connection

   In **AgentKit > Connections**, create a Microsoft To Do connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

   Scalekit credentials are available for Microsoft To Do, so you don't need to register an OAuth app.

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'microsofttodo'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Microsoft To Do:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'microsofttodo_lists_delta',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "microsofttodo"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Microsoft To Do:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="microsofttodo_lists_delta",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user signs in once. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'microsofttodo_attachment_get',
  toolInput: {
    attachment_id: '<attachment_id>',
    list_id: '<list_id>',
    task_id: '<task_id>',
  },
  connector: 'microsofttodo',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="microsofttodo_attachment_get",
    tool_input={
        "attachment_id": "<attachment_id>",
        "list_id": "<list_id>",
        "task_id": "<task_id>",
    },
    connection_name="microsofttodo",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `microsofttodo_attachment_get`

Get Attachment · Read-only

Get one file attachment of a Microsoft To Do task, including its content.
Returns the attachment's name, contentType, size and contentBytes (the file as base64).
Use this to read a file. Use microsofttodo_attachments_list to find the attachment_id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `attachment_id` (`string`, required): ID of the file attachment. Get it from microsofttodo_attachments_list. Example: AAMkADNkN2R1AAABEgAQAMkpJI_X-LBFgvrv1PlZYd8=
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"attachment_id":"<attachment_id>","list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_attachments_list`

List Attachments · Read-only

List the file attachments of a Microsoft To Do task.
Returns each attachment's id, name, contentType, size and lastModifiedDateTime, without the file content.
Use this to find an attachment_id. Use microsofttodo_attachment_get to download one file's content.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_checklist_items_list`

List Checklist Items · Read-only

List the checklist items (steps) of a Microsoft To Do task.
Returns each item's id, displayName, isChecked, createdDateTime and checkedDateTime.
Use this to read a task's steps. Use microsofttodo_task_get with expand=checklistItems to get the task and its steps together.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_linked_resources_list`

List Linked Resources · Read-only

List the linked resources of a Microsoft To Do task: links back to the item in another app that the task came from.
Returns each resource's id, webUrl, applicationName, displayName and externalId.
Use this to see where a task links to.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_list_get`

Get Task List · Read-only

Get one Microsoft To Do task list by ID.
Returns the list's id, displayName, isOwner, isShared and wellknownListName.
Use this when you already have a list_id. Use microsofttodo_lists_list to browse lists.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=

Example input: `{"list_id":"<list_id>"}`

### `microsofttodo_lists_delta`

Get Task List Changes · Read-only

Get Microsoft To Do task lists that were added, changed or deleted since a previous call.
Returns changed lists plus an @odata.nextLink (more pages, carries a $skiptoken) or an @odata.deltaLink (round finished, carries a $deltatoken).
Use this to sync lists incrementally. Use microsofttodo_lists_list for a plain listing.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `delta_token` (`string`, optional): The $deltatoken value from the @odata.deltaLink of a previous delta call. Omit it on the first call to get a full snapshot and a new delta link. Example: Ql1C2B2FCfQf8m3oJ1F2
- `skip_token` (`string`, optional): The $skiptoken value from the @odata.nextLink of the previous delta page, used while a delta round has more pages. Example: ZSfN8xsLv7m3HCMhvU

Example input: `{}`

### `microsofttodo_lists_list`

List Task Lists · Read-only

List the signed-in user's Microsoft To Do task lists.
Returns each list's id, displayName, isOwner, isShared and wellknownListName (defaultList, flaggedEmails or none).
Use this to find a list_id. Use microsofttodo_list_get for one list you already know.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `filter` (`string`, optional): OData $filter expression to narrow the lists. Example: displayName eq 'Groceries'
- `skip` (`integer`, optional): Number of lists to skip, for paging (OData $skip). Use the $skip value from the @odata.nextLink of the previous page. Example: 25
- `top` (`integer`, optional): Maximum number of lists to return in one page (OData $top). Example: 25

Example input: `{}`

### `microsofttodo_task_get`

Get Task · Read-only

Get one Microsoft To Do task by list ID and task ID.
Returns the task's title, status, importance, body, dates, recurrence, categories and, if expanded, its checklist items and linked resources.
Use this when you know the task_id. Use microsofttodo_tasks_list to find tasks.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
- `expand` (`string`, optional): Related items to include in the response (OData $expand): checklistItems, linkedResources or attachments, comma-separated. Example: checklistItems,linkedResources

Example input: `{"list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_tasks_delta`

Get Task Changes · Read-only

Get tasks in a Microsoft To Do task list that were added, changed or deleted since a previous call.
Returns changed tasks plus an @odata.nextLink (more pages, carries a $skiptoken) or an @odata.deltaLink (round finished, carries a $deltatoken).
Use this to sync tasks incrementally. Use microsofttodo_tasks_list for a plain listing.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `delta_token` (`string`, optional): The $deltatoken value from the @odata.deltaLink of a previous delta call. Omit it on the first call to get a full snapshot and a new delta link. Example: Ql1C2B2FCfQf8m3oJ1F2
- `skip_token` (`string`, optional): The $skiptoken value from the @odata.nextLink of the previous delta page, used while a delta round has more pages. Example: ZSfN8xsLv7m3HCMhvU

Example input: `{"list_id":"<list_id>"}`

### `microsofttodo_tasks_list`

List Tasks · Read-only

List the tasks in a Microsoft To Do task list, optionally filtered and sorted.
Returns each task's id, title, status, importance, body, dueDateTime, reminder settings, categories and timestamps.
Use this to browse or find tasks. Use microsofttodo_task_get for one task you already know.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `filter` (`string`, optional): OData $filter expression to narrow the tasks. Example: status ne 'completed'
- `orderby` (`string`, optional): Property to sort by, with an optional asc or desc (OData $orderby). Example: createdDateTime desc
- `select` (`string`, optional): Comma-separated properties to return (OData $select). Example: id,title,status,dueDateTime
- `skip` (`integer`, optional): Number of tasks to skip, for paging (OData $skip). Use the $skip value from the @odata.nextLink of the previous page. Example: 25
- `top` (`integer`, optional): Maximum number of tasks to return in one page (OData $top). Example: 25

Example input: `{"list_id":"<list_id>"}`

### `microsofttodo_attachment_create`

Add Attachment · Write

Attach a small file (under 3 MB) to a Microsoft To Do task, sent as base64 content.
Returns the new attachment's id, name, contentType and size.
Use this to add a file. Use microsofttodo_linked_resource_create to add a link instead.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `content_bytes` (`string`, required): The file content encoded as base64. The file must be under 3 MB. Example: JVBERi0xLjQK
- `content_type` (`string`, required): MIME type of the file. Example: application/pdf
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `name` (`string`, required): File name shown on the task. Example: receipt.pdf
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"content_bytes":"<content_bytes>","content_type":"<content_type>","list_id":"<list_id>","name":"<name>","task_id":"<task_id>"}`

### `microsofttodo_checklist_item_create`

Create Checklist Item · Write

Add a checklist item (step) to a Microsoft To Do task.
Returns the new checklist item with its id.
Use this to break a task into steps. Use microsofttodo_task_create to add a whole new task.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `display_name` (`string`, required): Text of the checklist item. Example: Collect receipts
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
- `is_checked` (`boolean`, optional): Whether the item starts checked off. Example: false

Example input: `{"display_name":"<display_name>","list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_checklist_item_update`

Update Checklist Item · Write

Update a checklist item (step) of a Microsoft To Do task, for example to check it off or change its text.
Returns the updated checklist item.
Use this to tick off or rename a step. Only the fields you pass are changed.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `checklist_item_id` (`string`, required): ID of the checklist item. Get it from microsofttodo_checklist_items_list. Example: 51d8a471-2e9d-4f53-9937-c33a8742d28f
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
- `display_name` (`string`, optional): New text of the checklist item. Example: Collect all receipts
- `is_checked` (`boolean`, optional): Set to true to check the item off, false to uncheck it. Example: true

Example input: `{"checklist_item_id":"<checklist_item_id>","list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_linked_resource_create`

Create Linked Resource · Write

Link a Microsoft To Do task to an item in another app, such as a ticket or a document.
Returns the new linked resource with its id.
Use this to attach a link to a task. Use microsofttodo_attachment_create to attach a file.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `application_name` (`string`, required): Name of the app the link points to. Example: Jira
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
- `web_url` (`string`, required): Deep link to the item in the other app. Example: https://contoso.atlassian.net/browse/OPS-42
- `display_name` (`string`, optional): Title shown for the link. Example: OPS-42 Rotate API keys
- `external_id` (`string`, optional): ID of the item in the other app. Example: OPS-42

Example input: `{"application_name":"<application_name>","list_id":"<list_id>","task_id":"<task_id>","web_url":"<web_url>"}`

### `microsofttodo_list_create`

Create Task List · Write

Create a new Microsoft To Do task list for the signed-in user.
Returns the new list with its id and displayName.
Use this to add a list. Use microsofttodo_task_create to add tasks to an existing list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `display_name` (`string`, required): Name of the new task list. Example: Groceries

Example input: `{"display_name":"<display_name>"}`

### `microsofttodo_list_update`

Rename Task List · Write

Rename a Microsoft To Do task list.
Returns the updated list.
Use this to change a list's name. Built-in lists such as Tasks and Flagged Emails cannot be renamed.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `display_name` (`string`, required): New name for the task list. Example: Weekend groceries
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=

Example input: `{"display_name":"<display_name>","list_id":"<list_id>"}`

### `microsofttodo_task_create`

Create Task · Write

Create a task in a Microsoft To Do task list.
Returns the new task with its id and all set properties.
Use this to add a task. Use microsofttodo_checklist_item_create to add steps to an existing task.
Requires a list_id from microsofttodo_lists_list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `title` (`string`, required): Short title of the task. Example: Send the Q3 report
- `body_content` (`string`, optional): Notes for the task, shown in the task details. Example: Attach the final numbers from finance.
- `body_content_type` (`string`, optional): Format of body_content: text or html. Defaults to text. Example: text. One of: `text`, `html`. Default: `text`.
- `categories` (`array`, optional): Category names to tag the task with. Each name must match an Outlook category of the user. Example: ["Red category"]
- `due_date_time` (`string`, optional): When the task is due, as a local date and time without offset, read in time_zone. Example: 2026-12-01T17:00:00
- `importance` (`string`, optional): Importance of the task: low, normal or high. Example: high. One of: `low`, `normal`, `high`.
- `is_reminder_on` (`boolean`, optional): Whether a reminder alert is set for the task. Example: true
- `recurrence` (`object`, optional): Recurrence of the task, as a Microsoft Graph patternedRecurrence object with a pattern (how often it repeats) and a range (when it starts and stops). Example: {"pattern": {"type": "weekly", "interval": 1, "daysOfWeek": ["monday"]}, "range": {"type": "noEnd", "startDate": "2026-11-16"}}
- `reminder_date_time` (`string`, optional): When to show a reminder, as a local date and time without offset, read in time_zone. Set is_reminder_on to true as well. Example: 2026-11-30T09:00:00
- `start_date_time` (`string`, optional): When the task is scheduled to start, as a local date and time without offset, read in time_zone. Example: 2026-11-20T09:00:00
- `status` (`string`, optional): Progress state of the task: notStarted, inProgress, completed, waitingOnOthers or deferred. Example: inProgress. One of: `notStarted`, `inProgress`, `completed`, `waitingOnOthers`, `deferred`.
- `time_zone` (`string`, optional): Time zone applied to every date you set in this call (due, start, reminder). Use a Windows or IANA time zone name. Defaults to UTC. Example: Pacific Standard Time. Default: `UTC`.

Example input: `{"list_id":"<list_id>","title":"<title>"}`

### `microsofttodo_task_update`

Update Task · Write

Update a Microsoft To Do task, for example to mark it completed, change its due date or rename it.
Returns the updated task.
Use this to change an existing task. Only the fields you pass are changed.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
- `body_content` (`string`, optional): Notes for the task, shown in the task details. Example: Attach the final numbers from finance.
- `body_content_type` (`string`, optional): Format of body_content: text or html. Defaults to text. Example: text. One of: `text`, `html`. Default: `text`.
- `categories` (`array`, optional): Category names to tag the task with. Each name must match an Outlook category of the user. Example: ["Red category"]
- `due_date_time` (`string`, optional): When the task is due, as a local date and time without offset, read in time_zone. Example: 2026-12-01T17:00:00
- `importance` (`string`, optional): Importance of the task: low, normal or high. Example: high. One of: `low`, `normal`, `high`.
- `is_reminder_on` (`boolean`, optional): Whether a reminder alert is set for the task. Example: true
- `recurrence` (`object`, optional): Recurrence of the task, as a Microsoft Graph patternedRecurrence object with a pattern (how often it repeats) and a range (when it starts and stops). Example: {"pattern": {"type": "weekly", "interval": 1, "daysOfWeek": ["monday"]}, "range": {"type": "noEnd", "startDate": "2026-11-16"}}
- `reminder_date_time` (`string`, optional): When to show a reminder, as a local date and time without offset, read in time_zone. Set is_reminder_on to true as well. Example: 2026-11-30T09:00:00
- `start_date_time` (`string`, optional): When the task is scheduled to start, as a local date and time without offset, read in time_zone. Example: 2026-11-20T09:00:00
- `status` (`string`, optional): Progress state of the task: notStarted, inProgress, completed, waitingOnOthers or deferred. Example: inProgress. One of: `notStarted`, `inProgress`, `completed`, `waitingOnOthers`, `deferred`.
- `time_zone` (`string`, optional): Time zone applied to every date you set in this call (due, start, reminder). Use a Windows or IANA time zone name. Defaults to UTC. Example: Pacific Standard Time. Default: `UTC`.
- `title` (`string`, optional): Short title of the task. Example: Send the Q3 report

Example input: `{"list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_attachment_delete`

Delete Attachment · Destructive

Delete a file attachment from a Microsoft To Do task.
Returns no content on success.
Use this to remove a file from a task.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `attachment_id` (`string`, required): ID of the file attachment. Get it from microsofttodo_attachments_list. Example: AAMkADNkN2R1AAABEgAQAMkpJI_X-LBFgvrv1PlZYd8=
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"attachment_id":"<attachment_id>","list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_checklist_item_delete`

Delete Checklist Item · Destructive

Delete a checklist item (step) from a Microsoft To Do task.
Returns no content on success.
Use this to remove a step. Use microsofttodo_checklist_item_update to check it off instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `checklist_item_id` (`string`, required): ID of the checklist item. Get it from microsofttodo_checklist_items_list. Example: 51d8a471-2e9d-4f53-9937-c33a8742d28f
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"checklist_item_id":"<checklist_item_id>","list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_linked_resource_delete`

Delete Linked Resource · Destructive

Remove a linked resource from a Microsoft To Do task.
Returns no content on success. The item in the other app is not touched.
Use this to drop a link from a task.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `linked_resource_id` (`string`, required): ID of the linked resource. Get it from microsofttodo_linked_resources_list. Example: f9cddce2-dce2-f9cd-e2dc-cdf9e2dccdf9
- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"linked_resource_id":"<linked_resource_id>","list_id":"<list_id>","task_id":"<task_id>"}`

### `microsofttodo_list_delete`

Delete Task List · Destructive

Permanently delete a Microsoft To Do task list and every task in it.
Returns no content on success.
Use this only when the whole list should go. Use microsofttodo_task_delete to remove a single task.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=

Example input: `{"list_id":"<list_id>"}`

### `microsofttodo_task_delete`

Delete Task · Destructive

Permanently delete a task from a Microsoft To Do task list.
Returns no content on success.
Use this to remove a task. Use microsofttodo_task_update with status completed to finish it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
- `task_id` (`string`, required): ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA

Example input: `{"list_id":"<list_id>","task_id":"<task_id>"}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
