microsoft-planner-mcp by vyente-ruffin - MCP Server

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.

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 build

Usage with Claude Code

Add the MCP server to Claude Code:

claude mcp add microsoft-planner-mcp node /path/to/microsoft-planner-mcp/dist/index.js

Or 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-plans`	List all Planner plans accessible to the current user
`list-buckets`	List all buckets in a plan
`list-tasks`	List all tasks in a Planner plan
`get-task`	Get details of a specific task
`get-task-details`	Get extended task details (description, checklist, references)
`create-task`	Create a new task in a plan
`update-task`	Update task properties (title, progress, assignments, categories)
`update-task-details`	Update task description (supports GitHub links)
`delete-task`	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-plans to discover all accessible plans and their IDs
Use list-buckets with your Plan ID to get bucket IDs
Or 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