Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Microsoft Planner

Scalekit connector
Open markdown

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

Tools
22
What they doRead · write · destructive
11 · 8 · 311 read8 write3 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 Planner connection

    In AgentKit > Connections, create a Microsoft Planner connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Microsoft Planner, 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 = 'microsoftplanner'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Microsoft Planner:', 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: 'microsoftplanner_my_tasks_list',
    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
  • microsoftplanner_bucket_getGet one Planner bucket by ID.Read-only

    Get Bucket

    Get one Planner bucket by ID. Returns the bucket's id, name, planId, orderHint and @odata.etag (needed to update or delete it). Use this when you know the bucket_id. Use microsoftplanner_buckets_list to browse.

    Inputs

    bucket_idstringrequired
    ID of the bucket. Get it from microsoftplanner_buckets_list. Example: hsOf2dhOJkqyYYZEtdzDe2QAIUCR
  • microsoftplanner_bucket_tasks_listList the tasks in one Planner bucket.Read-only

    List Bucket Tasks

    List the tasks in one Planner bucket. Returns each task's id, title, percentComplete, priority, dueDateTime, assignments and @odata.etag. Use this for one column. Use microsoftplanner_tasks_list for the whole plan.

    Inputs

    bucket_idstringrequired
    ID of the bucket. Get it from microsoftplanner_buckets_list. Example: hsOf2dhOJkqyYYZEtdzDe2QAIUCR
  • microsoftplanner_buckets_listList the buckets (columns) of a Planner plan.Read-only

    List Buckets

    List the buckets (columns) of a Planner plan. Returns each bucket's id, name, planId, orderHint and @odata.etag. Use this to find a bucket_id before creating or moving tasks.

    Inputs

    plan_idstringrequired
    ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM
  • microsoftplanner_group_plans_listList the Planner plans owned by a Microsoft 365 group.Read-only

    List Group Plans

    List the Planner plans owned by a Microsoft 365 group. Returns each plan's id, title, container, createdBy and @odata.etag. Use this when you know the group. Use microsoftplanner_plans_list for every plan shared with the user.

    Inputs

    group_idstringrequired
    ID of the Microsoft 365 group. A plan's container.containerId holds it. Example: ebf3b108-5234-4e22-b93d-656d7dae5874
  • microsoftplanner_my_tasks_listList the Planner tasks assigned to the signed-in user, across all plans.Read-only

    List My Tasks

    List the Planner tasks assigned to the signed-in user, across all plans. Returns each task's id, title, planId, bucketId, percentComplete, priority, dueDateTime and @odata.etag. Use this for the user's own to-dos. Use microsoftplanner_tasks_list for every task in a plan.

    Inputs

    This tool takes no inputs.

  • microsoftplanner_plan_details_getGet the details of a Planner plan.Read-only

    Get Plan Details

    Get the details of a Planner plan. Returns categoryDescriptions (the names of labels category1 to category25), sharedWith and @odata.etag. Use this to see what each label means before applying labels to tasks.

    Inputs

    plan_idstringrequired
    ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM
  • microsoftplanner_plan_getGet one Planner plan by ID.Read-only

    Get Plan

    Get one Planner plan by ID. Returns the plan's id, title, container, createdBy, createdDateTime and @odata.etag (needed to update or delete it). Use this when you know the plan_id. Use microsoftplanner_plan_details_get for its label names.

    Inputs

    plan_idstringrequired
    ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM
  • microsoftplanner_plans_listList the Planner plans shared with the signed-in user.Read-only

    List My Plans

    List the Planner plans shared with the signed-in user. Returns each plan's id, title, container (the group or roster that owns it), createdBy and @odata.etag. Use this to find a plan_id. Use microsoftplanner_group_plans_list for the plans of one Microsoft 365 group.

    Inputs

    This tool takes no inputs.