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.
- Tools
- 23
- What they doRead · write · destructive
- 10 · 8 · 510 read8 write5 destructive
- Users sign in with
- OAuth
- OAuth app
- Scalekit's or your own
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Microsoft To Do connection
In AgentKit > Connections, create a Microsoft To Do connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Scalekit credentials are available for Microsoft To Do, so you don't need to register an OAuth app.
Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'microsofttodo'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'microsofttodo_lists_delta',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "microsofttodo"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="microsofttodo_lists_delta",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolmicrosofttodo_attachment_getGet one file attachment of a Microsoft To Do task, including its content.Read-onlyGet Attachment
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.
Inputs
attachment_idstringrequired- ID of the file attachment. Get it from microsofttodo_attachments_list. Example: AAMkADNkN2R1AAABEgAQAMkpJI_X-LBFgvrv1PlZYd8=
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
microsofttodo_attachments_listList the file attachments of a Microsoft To Do task.Read-onlyList Attachments
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.
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
microsofttodo_checklist_items_listList the checklist items (steps) of a Microsoft To Do task.Read-onlyList Checklist Items
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.
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
microsofttodo_linked_resources_listList the linked resources of a Microsoft To Do task: links back to the item in another app that the task came from.Read-onlyList Linked Resources
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.
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
microsofttodo_list_getGet one Microsoft To Do task list by ID.Read-onlyGet Task List
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.
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
microsofttodo_lists_deltaGet Microsoft To Do task lists that were added, changed or deleted since a previous call.Read-onlyGet Task List Changes
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.
Inputs
delta_tokenstring- 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_tokenstring- The $skiptoken value from the @odata.nextLink of the previous delta page, used while a delta round has more pages. Example: ZSfN8xsLv7m3HCMhvU
microsofttodo_lists_listList the signed-in user's Microsoft To Do task lists.Read-onlyList Task Lists
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.
Inputs
filterstring- OData $filter expression to narrow the lists. Example: displayName eq 'Groceries'
skipinteger- Number of lists to skip, for paging (OData $skip). Use the $skip value from the @odata.nextLink of the previous page. Example: 25
topinteger- Maximum number of lists to return in one page (OData $top). Example: 25
microsofttodo_task_getGet one Microsoft To Do task by list ID and task ID.Read-onlyGet Task
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.
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
expandstring- Related items to include in the response (OData $expand): checklistItems, linkedResources or attachments, comma-separated. Example: checklistItems,linkedResources
microsofttodo_tasks_deltaGet tasks in a Microsoft To Do task list that were added, changed or deleted since a previous call.Read-onlyGet Task Changes
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.
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
delta_tokenstring- 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_tokenstring- The $skiptoken value from the @odata.nextLink of the previous delta page, used while a delta round has more pages. Example: ZSfN8xsLv7m3HCMhvU
microsofttodo_tasks_listList the tasks in a Microsoft To Do task list, optionally filtered and sorted.Read-onlyList Tasks
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.
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
filterstring- OData $filter expression to narrow the tasks. Example: status ne 'completed'
orderbystring- Property to sort by, with an optional asc or desc (OData $orderby). Example: createdDateTime desc
selectstring- Comma-separated properties to return (OData $select). Example: id,title,status,dueDateTime
skipinteger- Number of tasks to skip, for paging (OData $skip). Use the $skip value from the @odata.nextLink of the previous page. Example: 25
topinteger- Maximum number of tasks to return in one page (OData $top). Example: 25
microsofttodo_attachment_createAttach a small file (under 3 MB) to a Microsoft To Do task, sent as base64 content.WriteAdd Attachment
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.
Inputs
content_bytesstringrequired- The file content encoded as base64. The file must be under 3 MB. Example: JVBERi0xLjQK
content_typestringrequired- MIME type of the file. Example: application/pdf
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
namestringrequired- File name shown on the task. Example: receipt.pdf
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
microsofttodo_checklist_item_createAdd a checklist item (step) to a Microsoft To Do task.WriteCreate Checklist Item
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.
Inputs
display_namestringrequired- Text of the checklist item. Example: Collect receipts
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
is_checkedboolean- Whether the item starts checked off. Example: false
microsofttodo_checklist_item_updateUpdate a checklist item (step) of a Microsoft To Do task, for example to check it off or change its text.WriteUpdate Checklist Item
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.
- Idempotent
Inputs
checklist_item_idstringrequired- ID of the checklist item. Get it from microsofttodo_checklist_items_list. Example: 51d8a471-2e9d-4f53-9937-c33a8742d28f
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
display_namestring- New text of the checklist item. Example: Collect all receipts
is_checkedboolean- Set to true to check the item off, false to uncheck it. Example: true
microsofttodo_linked_resource_createLink a Microsoft To Do task to an item in another app, such as a ticket or a document.WriteCreate Linked Resource
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.
Inputs
application_namestringrequired- Name of the app the link points to. Example: Jira
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
web_urlstringrequired- Deep link to the item in the other app. Example: https://contoso.atlassian.net/browse/OPS-42
display_namestring- Title shown for the link. Example: OPS-42 Rotate API keys
external_idstring- ID of the item in the other app. Example: OPS-42
microsofttodo_list_createCreate a new Microsoft To Do task list for the signed-in user.WriteCreate Task List
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.
Inputs
display_namestringrequired- Name of the new task list. Example: Groceries
microsofttodo_list_updateRename a Microsoft To Do task list.WriteRename Task List
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.
- Idempotent
Inputs
display_namestringrequired- New name for the task list. Example: Weekend groceries
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
microsofttodo_task_createCreate a task in a Microsoft To Do task list.WriteCreate Task
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.
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
titlestringrequired- Short title of the task. Example: Send the Q3 report
body_contentstring- Notes for the task, shown in the task details. Example: Attach the final numbers from finance.
body_content_typestring- Format of body_content: text or html. Defaults to text. Example: textone of
texthtmldefaulttext categoriesarray- Category names to tag the task with. Each name must match an Outlook category of the user. Example: ["Red category"]
due_date_timestring- When the task is due, as a local date and time without offset, read in time_zone. Example: 2026-12-01T17:00:00
importancestring- Importance of the task: low, normal or high. Example: highone of
lownormalhigh is_reminder_onboolean- Whether a reminder alert is set for the task. Example: true
recurrenceobject- 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_timestring- 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_timestring- 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
statusstring- Progress state of the task: notStarted, inProgress, completed, waitingOnOthers or deferred. Example: inProgressone of
notStartedinProgresscompletedwaitingOnOthersdeferred time_zonestring- 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 Timedefault
UTC
microsofttodo_task_updateUpdate a Microsoft To Do task, for example to mark it completed, change its due date or rename it.WriteUpdate Task
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.
- Idempotent
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
body_contentstring- Notes for the task, shown in the task details. Example: Attach the final numbers from finance.
body_content_typestring- Format of body_content: text or html. Defaults to text. Example: textone of
texthtmldefaulttext categoriesarray- Category names to tag the task with. Each name must match an Outlook category of the user. Example: ["Red category"]
due_date_timestring- When the task is due, as a local date and time without offset, read in time_zone. Example: 2026-12-01T17:00:00
importancestring- Importance of the task: low, normal or high. Example: highone of
lownormalhigh is_reminder_onboolean- Whether a reminder alert is set for the task. Example: true
recurrenceobject- 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_timestring- 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_timestring- 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
statusstring- Progress state of the task: notStarted, inProgress, completed, waitingOnOthers or deferred. Example: inProgressone of
notStartedinProgresscompletedwaitingOnOthersdeferred time_zonestring- 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 Timedefault
UTC titlestring- Short title of the task. Example: Send the Q3 report
microsofttodo_attachment_deleteDelete a file attachment from a Microsoft To Do task.DestructiveDelete Attachment
Delete a file attachment from a Microsoft To Do task. Returns no content on success. Use this to remove a file from a task.
- Idempotent
Inputs
attachment_idstringrequired- ID of the file attachment. Get it from microsofttodo_attachments_list. Example: AAMkADNkN2R1AAABEgAQAMkpJI_X-LBFgvrv1PlZYd8=
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
microsofttodo_checklist_item_deleteDelete a checklist item (step) from a Microsoft To Do task.DestructiveDelete Checklist Item
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.
- Idempotent
Inputs
checklist_item_idstringrequired- ID of the checklist item. Get it from microsofttodo_checklist_items_list. Example: 51d8a471-2e9d-4f53-9937-c33a8742d28f
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
microsofttodo_linked_resource_deleteRemove a linked resource from a Microsoft To Do task.DestructiveDelete Linked Resource
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.
- Idempotent
Inputs
linked_resource_idstringrequired- ID of the linked resource. Get it from microsofttodo_linked_resources_list. Example: f9cddce2-dce2-f9cd-e2dc-cdf9e2dccdf9
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
microsofttodo_list_deletePermanently delete a Microsoft To Do task list and every task in it.DestructiveDelete Task List
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.
- Idempotent
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
microsofttodo_task_deletePermanently delete a task from a Microsoft To Do task list.DestructiveDelete Task
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.
- Idempotent
Inputs
list_idstringrequired- ID of the To Do task list. Get it from microsofttodo_lists_list. Example: AAMkADIyAAAAABrJAAA=
task_idstringrequired- ID of the task inside the list. Get it from microsofttodo_tasks_list. Example: AAkALgAAAAAAHYQDEapmEc2byACqAC-EWg0AFAAAA
No tools match.