Microsoft Planner MCP
Enables management of Microsoft Planner tasks with support for including GitHub repository links in task descriptions and integrating GitHub PR references with Planner workflows.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Microsoft Planner MCP list all tasks in the marketing campaign plan"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
microsoft-planner-mcp
Lightweight MCP (Model Context Protocol) server for Microsoft Planner that uses az rest for authentication instead of complex OAuth flows.
What This Is
A minimal MCP server that enables Claude Code to interact with Microsoft Planner tasks directly. It leverages Azure CLI's existing authentication (az login) to make Graph API calls, eliminating the need for app registrations or token management.
Related MCP server: microsoft-tasks-mcp
Prerequisites
Node.js (v18 or later)
Azure CLI installed and authenticated:
az login
Installation
git clone https://github.com/vyente-ruffin/microsoft-planner-mcp.git
cd microsoft-planner-mcp
npm install
npm run buildUsage with Claude Code
Add the MCP server to Claude Code:
claude mcp add microsoft-planner-mcp node /path/to/microsoft-planner-mcp/dist/index.jsOr add directly to your MCP settings file:
{
"mcpServers": {
"microsoft-planner-mcp": {
"command": "node",
"args": ["/path/to/microsoft-planner-mcp/dist/index.js"]
}
}
}Available Tools
Tool | Description |
| List all Planner plans accessible to the current user |
| List all buckets in a plan |
| List all tasks in a Planner plan |
| Get details of a specific task |
| Get extended task details (description, checklist, references) |
| Create a new task in a plan |
| Update task properties (title, progress, assignments, categories) |
| Update task description (supports GitHub links) |
| Delete a Planner task |
Claude Code Agent (Optional)
For enhanced automation, create a Claude Code agent at ~/.claude/agents/microsoft-planner.md with:
Auto-assignment: Automatically assign tasks to a default user
Auto-labeling: Apply default categories/labels to tasks
Status Intelligence: Infer task bucket and progress from conversation context
GitHub Integration: Include repository links in task descriptions
See the agent template for configuration details.
Finding Your IDs
To use the MCP tools, you'll need your Planner Plan ID and Bucket IDs:
Use
list-plansto discover all accessible plans and their IDsUse
list-bucketswith your Plan ID to get bucket IDsOr find your Plan ID from the Planner web URL:
https://tasks.office.com/...planId=YOUR_PLAN_ID
Example Usage
Once configured, use natural language with Claude Code:
"List all my planner plans"
"List all tasks in the planner"
"Create a task called 'Review PR #123' in the backlog bucket"
"Mark task XYZ as complete"
"Add a description with the GitHub PR link to the task"How It Works
This server uses az rest to make Microsoft Graph API calls. The Azure CLI handles all authentication, so as long as you're logged in with az login, the server can access Planner data your account has permissions for.
All Planner operations that require ETags (update, delete) automatically fetch the current ETag before making changes.
License
ISC
Available Tools
9 toolscreate-taskC
Create a new task in a Planner plan
Inputs: planId (required), bucketId (required), title (required).
delete-taskB
Delete a Planner task. Auto-fetches ETag.
Inputs: taskId (required).
get-taskC
Get details of a specific Planner task
Inputs: taskId (required).
get-task-detailsC
Get extended task details including description and checklist
Inputs: taskId (required).
list-bucketsC
List all buckets in a Planner plan
Inputs: planId (required).
list-plansB
List all Planner plans accessible to the current user
Inputs: no named parameters.
list-tasksC
List all tasks in a Planner plan
Inputs: planId (required).
update-taskC
Update task properties (title, progress, assignments, categories). Auto-fetches ETag.
Inputs: taskId (required), title, percentComplete, assignUserId, +1 more.
update-task-detailsA
Update task description (use for GitHub links). Auto-fetches ETag.
Inputs: taskId (required), description (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Most tools are clearly distinct, but 'get-task' and 'get-task-details' could cause confusion as they both retrieve task information. The descriptions help clarify that one gets basic details and the other extended details, but an agent might initially misselect between them.
All tool names follow a consistent verb_noun pattern with hyphens (e.g., create-task, list-tasks). The naming is predictable and readable throughout the set, with no deviations in style.
With 9 tools, this server is well-scoped for managing Microsoft Planner tasks and plans. Each tool serves a clear purpose, such as CRUD operations for tasks and listing plans/buckets, making the count appropriate for the domain.
The tool set provides strong coverage for task management, including create, read, update, and delete operations, plus listing plans and buckets. A minor gap is the lack of tools for managing buckets or plans beyond listing, but agents can still handle core workflows effectively.
Maintenance
Related MCP Connectors
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Plan and track your tasks: create, schedule and update PerspecTask tasks and link GitHub PRs.
Your planner in every AI chat: tasks, calendar, docs, habits, goals and memory, over MCP.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables comprehensive Microsoft To Do task management through Microsoft Graph API with Entra ID OAuth authentication. Supports creating, updating, and managing todo lists, tasks, reminders, and due dates through natural language.-
- AlicenseAqualityBmaintenanceEnables AI coding agents to read Microsoft Planner and To Do tasks across multiple M365 tenants with proper authentication, and supports optional write operations limited to tasks the agent created.1443 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to create and manage Microsoft Planner tasks, including comments, subtasks, and bucket operations, via a Node.js MCP server wrapping a Python CLI.3MIT
- AlicenseAqualityDmaintenanceEnables Claude to manage Microsoft Planner plans, buckets, and tasks via the Microsoft Graph API with OAuth 2.0 authentication.141ISC