> **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 Planner

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.

**Authentication:** OAuth 2.0
**Categories:** Project Management, Collaboration
**Tools:** 22: 11 read, 8 write, 3 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=MICROSOFTPLANNER)

## 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 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](/agentkit/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

   **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 = '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)
   ```

   ```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 = "microsoftplanner"
   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 Planner:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="microsoftplanner_my_tasks_list",
       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: 'microsoftplanner_bucket_get',
  toolInput: {
    bucket_id: '<bucket_id>',
  },
  connector: 'microsoftplanner',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="microsoftplanner_bucket_get",
    tool_input={
        "bucket_id": "<bucket_id>",
    },
    connection_name="microsoftplanner",
    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.

### `microsoftplanner_bucket_get`

Get Bucket · Read-only

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.

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

Inputs:

- `bucket_id` (`string`, required): ID of the bucket. Get it from microsoftplanner_buckets_list. Example: hsOf2dhOJkqyYYZEtdzDe2QAIUCR

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

### `microsoftplanner_bucket_tasks_list`

List Bucket Tasks · Read-only

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.

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

Inputs:

- `bucket_id` (`string`, required): ID of the bucket. Get it from microsoftplanner_buckets_list. Example: hsOf2dhOJkqyYYZEtdzDe2QAIUCR

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

### `microsoftplanner_buckets_list`

List Buckets · Read-only

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.

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

Inputs:

- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM

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

### `microsoftplanner_group_plans_list`

List Group Plans · Read-only

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.

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

Inputs:

- `group_id` (`string`, required): ID of the Microsoft 365 group. A plan's container.containerId holds it. Example: ebf3b108-5234-4e22-b93d-656d7dae5874

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

### `microsoftplanner_my_tasks_list`

List My Tasks · Read-only

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.

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

Inputs: none.

Example input: `{}`

### `microsoftplanner_plan_details_get`

Get Plan Details · Read-only

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.

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

Inputs:

- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM

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

### `microsoftplanner_plan_get`

Get Plan · Read-only

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.

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

Inputs:

- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM

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

### `microsoftplanner_plans_list`

List My Plans · Read-only

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.

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

Inputs: none.

Example input: `{}`

### `microsoftplanner_task_details_get`

Get Task Details · Read-only

Get the details of a Planner task.
Returns the task's description, checklist items, references (links), previewType and @odata.etag.
Use this to read a task's notes and checklist. Use microsoftplanner_task_get for its title, dates and assignees.

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

Inputs:

- `task_id` (`string`, required): ID of the Planner task. Get it from microsoftplanner_tasks_list or microsoftplanner_my_tasks_list. Example: 01gzSlKkIUSUl6DF_EilrmQAKDhh

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

### `microsoftplanner_task_get`

Get Task · Read-only

Get one Planner task by ID.
Returns the task's title, planId, bucketId, dates, percentComplete, priority, assignments, appliedCategories and @odata.etag (needed to update or delete it).
Use this when you know the task_id. Use microsoftplanner_task_details_get for its description and checklist.

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

Inputs:

- `task_id` (`string`, required): ID of the Planner task. Get it from microsoftplanner_tasks_list or microsoftplanner_my_tasks_list. Example: 01gzSlKkIUSUl6DF_EilrmQAKDhh

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

### `microsoftplanner_tasks_list`

List Plan Tasks · Read-only

List the tasks in a Planner plan.
Returns each task's id, title, bucketId, percentComplete, priority, dueDateTime, assignments, appliedCategories and @odata.etag.
Use this to browse a plan. Use microsoftplanner_bucket_tasks_list for one bucket, or microsoftplanner_my_tasks_list for the user's own tasks.

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

Inputs:

- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM

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

### `microsoftplanner_bucket_create`

Create Bucket · Write

Create a bucket (column) in a Planner plan.
Returns the new bucket with its id and @odata.etag.
Use this to add a column to a plan. Use microsoftplanner_task_create to add tasks to it.

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

Inputs:

- `name` (`string`, required): Name of the bucket. Example: In review
- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM
- `order_hint` (`string`, optional): Planner order hint that sets the position in the list. Use " !" to put the item first. Example:  !

Example input: `{"name":"<name>","plan_id":"<plan_id>"}`

### `microsoftplanner_bucket_update`

Update Bucket · Write

Rename or reorder a Planner bucket.
Returns the updated bucket, including its new @odata.etag.
Use this to change a bucket's name or position. Only the fields you pass are changed.
Requires the bucket's current etag from microsoftplanner_bucket_get.

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

Inputs:

- `bucket_id` (`string`, required): ID of the bucket. Get it from microsoftplanner_buckets_list. Example: hsOf2dhOJkqyYYZEtdzDe2QAIUCR
- `etag` (`string`, required): Current ETag of the bucket, sent as the If-Match header. Planner rejects the change with 412 if the bucket changed since you read it. Copy the @odata.etag value from microsoftplanner_bucket_get. Example: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
- `name` (`string`, optional): New name of the bucket. Example: Done
- `order_hint` (`string`, optional): Planner order hint that sets the position in the list. Use " !" to put the item first. Example:  !

Example input: `{"bucket_id":"<bucket_id>","etag":"<etag>"}`

### `microsoftplanner_plan_create`

Create Plan · Write

Create a Planner plan in a Microsoft 365 group.
Returns the new plan with its id and @odata.etag.
Use this to start a new plan. Use microsoftplanner_bucket_create and microsoftplanner_task_create to fill it.
The signed-in user must be a member of the group.

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

Inputs:

- `group_id` (`string`, required): ID of the Microsoft 365 group that will own the plan. Example: ebf3b108-5234-4e22-b93d-656d7dae5874
- `title` (`string`, required): Title of the plan. Example: Q1 launch

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

### `microsoftplanner_plan_details_update`

Update Plan Labels · Write

Rename the labels of a Planner plan.
Returns the updated plan details, including the new @odata.etag.
Use this to name labels. Use microsoftplanner_task_update with applied_categories to put labels on a task.
Requires the plan details' etag from microsoftplanner_plan_details_get.

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

Inputs:

- `category_descriptions` (`object`, required): Label names to set. Keys are category1 to category25 and values are the label names; null clears a name. Example: {"category1": "Blocked", "category2": "Marketing"}
- `etag` (`string`, required): Current ETag of the plan details, sent as the If-Match header. Planner rejects the change with 412 if the plan details changed since you read it. Copy the @odata.etag value from microsoftplanner_plan_details_get. Example: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM

Example input: `{"category_descriptions":{"category1":"Blocked","category2":"Marketing"},"etag":"<etag>","plan_id":"<plan_id>"}`

### `microsoftplanner_plan_update`

Rename Plan · Write

Rename a Planner plan.
Returns the updated plan, including its new @odata.etag.
Use this to change a plan's title. Use microsoftplanner_plan_details_update to rename its labels.
Requires the plan's current etag from microsoftplanner_plan_get.

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

Inputs:

- `etag` (`string`, required): Current ETag of the plan, sent as the If-Match header. Planner rejects the change with 412 if the plan changed since you read it. Copy the @odata.etag value from microsoftplanner_plan_get. Example: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM
- `title` (`string`, required): New title of the plan. Example: Q1 launch (final)

Example input: `{"etag":"<etag>","plan_id":"<plan_id>","title":"<title>"}`

### `microsoftplanner_task_create`

Create Task · Write

Create a task in a Planner plan, optionally in a bucket and assigned to users.
Returns the new task with its id and @odata.etag.
Use this to add a task. Use microsoftplanner_task_details_update to add a description or checklist afterwards.

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

Inputs:

- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM
- `title` (`string`, required): Title of the task. Example: Draft launch email
- `applied_categories` (`object`, optional): Labels to turn on or off. Keys are category1 to category25 and values are true or false; the label names are set on the plan details. Example: {"category1": true, "category4": false}
- `assignee_user_ids` (`array`, optional): Microsoft Entra user IDs to assign the task to. Example: ["fbab97d0-4932-4511-b675-204639209557"]
- `bucket_id` (`string`, optional): ID of the bucket to put the task in. The bucket must be in the same plan. Example: hsOf2dhOJkqyYYZEtdzDe2QAIUCR
- `due_date_time` (`string`, optional): When the task is due, as an ISO 8601 UTC timestamp. Example: 2026-12-01T17:00:00Z
- `percent_complete` (`integer`, optional): Progress of the task. Planner shows 0 as not started, 1 to 99 as in progress and 100 as completed. Example: 50
- `priority` (`integer`, optional): Priority from 0 to 10. Planner shows 1 as urgent, 3 as important, 5 as medium and 9 as low. Example: 3
- `start_date_time` (`string`, optional): When the task starts, as an ISO 8601 UTC timestamp. Example: 2026-11-20T09:00:00Z

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

### `microsoftplanner_task_details_update`

Update Task Details · Write

Update the description, checklist or links of a Planner task.
Returns the updated task details, including the new @odata.etag.
Use this for a task's notes and checklist. Use microsoftplanner_task_update for its title, dates and assignees.
Requires the task details' etag from microsoftplanner_task_details_get.

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

Inputs:

- `etag` (`string`, required): Current ETag of the task details, sent as the If-Match header. Planner rejects the change with 412 if the task details changed since you read it. Copy the @odata.etag value from microsoftplanner_task_details_get. Example: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
- `task_id` (`string`, required): ID of the Planner task. Get it from microsoftplanner_tasks_list or microsoftplanner_my_tasks_list. Example: 01gzSlKkIUSUl6DF_EilrmQAKDhh
- `checklist` (`object`, optional): Checklist items to add, change or remove. Each key is an item ID: a new GUID you make up for a new item, or an existing ID to change it. Each value has a title and isChecked flag and must include "@odata.type": "microsoft.graph.plannerChecklistItem"; set a value to null to remove that item. Example: {"95e27074-6c4a-447a-aa24-9d718a0b86fa": {"@odata.type": "microsoft.graph.plannerChecklistItem", "title": "Get sign-off", "isChecked": false}}
- `description` (`string`, optional): Description (notes) of the task, in plain text. Example: Use the copy from the brand team.
- `preview_type` (`string`, optional): What the task card shows: automatic, noPreview, checklist, description or reference. Example: checklist. One of: `automatic`, `noPreview`, `checklist`, `description`, `reference`.
- `references` (`object`, optional): Links to add, change or remove. Each key is the link URL, encoded so that %, ., :, @ and # become %25, %2E, %3A, %40 and %23. Each value must include "@odata.type": "microsoft.graph.plannerExternalReference" and can carry an alias and a type such as Word or Other; set a value to null to remove that link. Example: {"https%3A//contoso%2Ecom/brief": {"@odata.type": "microsoft.graph.plannerExternalReference", "alias": "Brief", "type": "Other"}}

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

### `microsoftplanner_task_update`

Update Task · Write

Update a Planner task: rename it, move it to another bucket, change its dates, progress, priority or labels, or assign and unassign users.
Returns the updated task, including its new @odata.etag.
Use this to change an existing task; set percent_complete to 100 to complete it. Only the fields you pass are changed.
Requires the task's current etag from microsoftplanner_task_get.

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

Inputs:

- `etag` (`string`, required): Current ETag of the task, sent as the If-Match header. Planner rejects the change with 412 if the task changed since you read it. Copy the @odata.etag value from microsoftplanner_task_get. Example: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
- `task_id` (`string`, required): ID of the Planner task. Get it from microsoftplanner_tasks_list or microsoftplanner_my_tasks_list. Example: 01gzSlKkIUSUl6DF_EilrmQAKDhh
- `applied_categories` (`object`, optional): Labels to turn on or off. Keys are category1 to category25 and values are true or false; the label names are set on the plan details. Example: {"category1": true, "category4": false}
- `assign_user_ids` (`array`, optional): Microsoft Entra user IDs to add as assignees. Example: ["fbab97d0-4932-4511-b675-204639209557"]
- `bucket_id` (`string`, optional): ID of the bucket to put the task in. The bucket must be in the same plan. Example: hsOf2dhOJkqyYYZEtdzDe2QAIUCR
- `due_date_time` (`string`, optional): When the task is due, as an ISO 8601 UTC timestamp. Example: 2026-12-01T17:00:00Z
- `percent_complete` (`integer`, optional): Progress of the task. Planner shows 0 as not started, 1 to 99 as in progress and 100 as completed. Example: 50
- `priority` (`integer`, optional): Priority from 0 to 10. Planner shows 1 as urgent, 3 as important, 5 as medium and 9 as low. Example: 3
- `start_date_time` (`string`, optional): When the task starts, as an ISO 8601 UTC timestamp. Example: 2026-11-20T09:00:00Z
- `title` (`string`, optional): Title of the task. Example: Draft launch email
- `unassign_user_ids` (`array`, optional): Microsoft Entra user IDs to remove from the assignees. Example: ["6463a5ce-2119-4198-9f2a-628761df4a62"]

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

### `microsoftplanner_bucket_delete`

Delete Bucket · Destructive

Permanently delete a Planner bucket and the tasks in it.
Returns no content on success.
Use this to remove a column. Move tasks out first with microsoftplanner_task_update if you want to keep them.
Requires the bucket's current etag from microsoftplanner_bucket_get.

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

Inputs:

- `bucket_id` (`string`, required): ID of the bucket. Get it from microsoftplanner_buckets_list. Example: hsOf2dhOJkqyYYZEtdzDe2QAIUCR
- `etag` (`string`, required): Current ETag of the bucket, sent as the If-Match header. Planner rejects the change with 412 if the bucket changed since you read it. Copy the @odata.etag value from microsoftplanner_bucket_get. Example: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="

Example input: `{"bucket_id":"<bucket_id>","etag":"<etag>"}`

### `microsoftplanner_plan_delete`

Delete Plan · Destructive

Permanently delete a Planner plan with all its buckets and tasks.
Returns no content on success.
Use this only when the whole plan should go. Use microsoftplanner_task_delete to remove one task.
Requires the plan's current etag from microsoftplanner_plan_get.

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

Inputs:

- `etag` (`string`, required): Current ETag of the plan, sent as the If-Match header. Planner rejects the change with 412 if the plan changed since you read it. Copy the @odata.etag value from microsoftplanner_plan_get. Example: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
- `plan_id` (`string`, required): ID of the Planner plan. Get it from microsoftplanner_plans_list or microsoftplanner_group_plans_list. Example: xqQg5FS2LkCp935s-FIFm2QAFkHM

Example input: `{"etag":"<etag>","plan_id":"<plan_id>"}`

### `microsoftplanner_task_delete`

Delete Task · Destructive

Permanently delete a Planner task.
Returns no content on success.
Use this to remove a task. Use microsoftplanner_task_update with percent_complete 100 to complete it instead.
Requires the task's current etag from microsoftplanner_task_get.

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

Inputs:

- `etag` (`string`, required): Current ETag of the task, sent as the If-Match header. Planner rejects the change with 412 if the task changed since you read it. Copy the @odata.etag value from microsoftplanner_task_get. Example: W/"JzEtVGFzayAgQEBAQEBAQEBAQEBAQEBAWCc="
- `task_id` (`string`, required): ID of the Planner task. Get it from microsoftplanner_tasks_list or microsoftplanner_my_tasks_list. Example: 01gzSlKkIUSUl6DF_EilrmQAKDhh

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

## Related

Other Project Management connectors ([all 67](/agentkit/connectors/?category=project-management)):

- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools
- [Airtable](/agentkit/connectors/airtable/): Scalekit connector, OAuth, 26 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 |
