Microsoft Planner

io.github.selicPublished by GitHub account selicv0.2.0Updated Oct 24, 2026

Microsoft Planner MCP server — plans, buckets, tasks via Microsoft Graph, ETags handled

The publisher's own server: Microsoft Learn MCP

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

A local MCP server that lets an assistant work with Microsoft Planner plans, buckets and tasks through the Microsoft Graph API.

What you can do
Find Microsoft 365 groups and users to get IDs for plans and assignments, and list a group's plans with their buckets and create new buckets. List tasks in a plan or bucket, list all tasks assigned to a user, and read a task with its description and checklist. Create tasks with bucket, due date, priority, assignees and description, and update title, bucket, due date, priority, progress or assignees. Edit task descriptions and add or check off checklist items, and permanently delete tasks. Optionally enable an advanced read-only toolset that searches a curated catalog of Graph endpoints and performs GET requests limited to planner, groups and users paths.
When to use it
Useful when you keep work in Microsoft Planner and want an assistant to look up plans and assignments or create, update and complete tasks without switching to the Planner interface. Also suited to bulk or cross-plan task reviews, such as listing everything assigned to one person.
Requirements
Runs locally via npx with Node.js, or as a Docker container or HTTP server. Needs a Microsoft Entra ID app registration with application permissions Tasks.ReadWrite.All, GroupMember.Read.All and User.Read.All, admin consent, and a client secret. Configure MS_TENANT_ID, MS_CLIENT_ID and MS_CLIENT_SECRET; delegated mode uses a public app registration and MS_REFRESH_TOKEN instead.
Before you install
The client secret and any refresh token are credentials that grant access to Planner data; the refresh token acts as the signed-in user and stays valid about 90 days past last use. The server can create, update and permanently delete tasks, and writes are attributed to the app registration or the delegated user. Access is governed only by the app registration's granted Graph permissions, so scope them narrowly. The advanced toolset is read-only and limited to planner, groups and users paths.

Installation

In SourceWeft

  1. Open Microsoft Planner in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-planner

MCP server for Microsoft Planner via the Microsoft Graph API. Find groups and plans, list buckets and tasks, and create, update, assign, complete, or delete tasks — including descriptions and checklists — with Planner's ETag concurrency handled automatically.

Sibling project to mcp-itglue and mcp-connectwise-psa — same architecture.

Tools

ToolDescription
planner_search_groupsFind Microsoft 365 groups (Teams) by name → group ID
planner_find_userFind a user by name/UPN → user ID for assignments
planner_list_plansList plans owned by a group
planner_get_planPlan + its buckets
planner_create_bucketCreate a bucket in a plan
planner_list_tasksTasks in a plan or bucket (filter by assignee, open/completed)
planner_list_user_tasksAll tasks assigned to a user, across plans
planner_get_taskTask with description and checklist
planner_create_taskCreate task (bucket, due date, priority, assignees, description)
planner_update_taskUpdate title/bucket/due/priority/progress/assignees
planner_update_task_detailsUpdate description; add or (un)check checklist items
planner_delete_taskPermanently delete a task
graph_find_endpoint †Search a curated catalog of the /planner, /groups, /users Graph surface
graph_get †Read-only GET for any Graph v1.0 path under /planner, /groups, /users

† Advanced toolset (opt-in, off by default) — an escape hatch for Graph surface the curated tools don't wrap. Enable with PLANNER_ADVANCED_TOOLSET=true or --advanced. graph_get is verb-locked to GET, rejects /beta, and only reaches the three path prefixes above, so a shared app registration's other permissions (e.g. mail) stay out of reach.

Setup

1. Entra ID app registration

  1. Entra admin center → App registrations → New registration
  2. API permissions → Application permissions → add Tasks.ReadWrite.All, GroupMember.Read.All, User.Read.All → Grant admin consent
  3. Certificates & secrets → New client secret — note the value

2. Run

bash
MS_TENANT_ID=<tenant> MS_CLIENT_ID=<client-id> MS_CLIENT_SECRET=<secret> npx -y mcp-planner

Claude Code:

bash
claude mcp add planner --env MS_TENANT_ID=<tenant> --env MS_CLIENT_ID=<client-id> --env MS_CLIENT_SECRET=<secret> -- npx -y mcp-planner

HTTP mode

bash
npx -y mcp-planner --transport http --port 3000

Sessions authenticate per-request (BYOK) with x-ms-tenant-id + x-ms-client-id plus either x-ms-client-secret (app-only) or x-ms-refresh-token (delegated — see below), or fall back to the MS_* environment credentials when set. When both a secret and a refresh token arrive, the refresh token wins (header-overlay proxies can add but not remove headers). Health probe at GET /health.

Delegated mode — act as the signed-in user

App-only sessions act as the app registration; delegated sessions act as a user: their Planner permissions apply and every write is attributed to them.

  1. A separate, public app registration: Authentication → Allow public client flows → Yes; API permissions → Delegated Tasks.ReadWrite, Group.Read.All, User.ReadBasic.All (+ admin consent where the tenant requires it).
  2. Each user signs in once via the device-code helper and keeps the printed refresh token:
bash
node scripts/device-login.mjs --tenant <tenant-id> --client <public-client-id>
  1. Use MS_REFRESH_TOKEN instead of MS_CLIENT_SECRET (stdio), or the x-ms-refresh-token header (HTTP). Behind the MCP gateway, register it as a personal credential (field x-ms-refresh-token).

The refresh token is a secret — it acts as you — and stays valid ~90 days past its last use; re-run the helper when it expires.

Docker

bash
docker build -t mcp-planner .docker run -p 3000:3000 -e MS_TENANT_ID=... -e MS_CLIENT_ID=... -e MS_CLIENT_SECRET=... mcp-planner

Access model

No MCP-level role gating: the Entra app registration's granted Graph permissions are the access control. Point sessions at different app registrations (BYOK headers) to scope what they can do.

Notes

  • Planner requires an If-Match ETag on every update/delete — the tools fetch the current resource and pass its ETag automatically. On a 412 (concurrent change), just retry.
  • Priority mapping: urgent=1, important=3, medium=5, low=9 (Graph uses 0–10).
  • Progress: not started (0), in progress (50), completed (100).

Development

bash
npm installnpm run dev        # stdionpm run dev:http   # httpnpm testnpm run buildnpm run bundle     # Claude Desktop .mcpb

License

MIT

Source: README.md at commit 0d89d41

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Microsoft integrations

Microsoft Learn MCP

com.microsoftOfficial publisher

A free remote MCP server that lets an AI assistant search official Microsoft Learn documentation, find code samples, and fetch documentation pages as markdown.

Streamable HTTPWeb executable
Developer Tools3 toolsOct 24, 2026

Playwright Cloud Browsers

com.microsoftOfficial publisher

Remote MCP server giving AI agents managed Playwright cloud browsers to create sessions, navigate and inspect pages, and interact with elements.

Streamable HTTPWeb executable
Browser AutomationNot indexed yetOct 29, 2026

Microsoft Sentinel Data Exploration

com.microsoftOfficial publisher

Remote Microsoft Sentinel MCP server that lets an assistant find relevant tables and retrieve security data from the Sentinel data lake using natural language.

Streamable HTTPWeb executableAuth
Security & MonitoringCredential requiredOct 24, 2026

Visio

com.microsoft

Lets an assistant create, update and read Microsoft Visio diagrams by driving the Visio desktop application on the user's Windows machine.

STDIODesktop only
Productivity & WorkflowNot validated · the package type cannot run in the sandboxNov 5, 2026

Microsoft Clarity MCP

Published by GitHub account surendranb

Local MCP server that pulls Microsoft Clarity behavioral UX data — rage clicks, dead clicks, quick backs and JS errors — into an AI assistant.

STDIODesktop only
Data & Analytics7 toolsNov 3, 2026