Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Microsoft To Do

Scalekit connector
Open markdown

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 app
Scalekit's or your own

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  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.

    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

    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.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)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • microsofttodo_attachment_getGet one file attachment of a Microsoft To Do task, including its content.Read-only

    Get 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-only

    List 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-only

    List 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-only

    List 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-only

    Get 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-only

    Get 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-only

    List 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-only

    Get 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