vyente-ruffin/microsoft-planner-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

11 stars 8 forks 质量 54 趋势 8

Repository Install

Lightweight MCP server for Microsoft Planner using az rest for authentication

概览

Lightweight MCP (Model Context Protocol) server for Microsoft Planner that uses az rest for authentication instead of complex OAuth flows. 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. - (v18 or later) - installed and authenticated: Or add directly to your MCP settings file: For enhanced automation, create a Claude Code agent at ~/.claude/agents/microsoft-planner.md with: - : Automatically assign tasks to a default user - : Apply default categories/labels to tasks - : Infer task bucket and progress from conversation context - : Include repository links in task descriptions See the agent template for configuration details. To use the MCP tools, you'll need your Planner Plan ID and Bucket IDs:

README

以下为原文 README 节选，完整内容请查看原文。

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

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "microsoft-planner-mcp": {
      "command": "node",
      "args": ["/path/to/microsoft-planner-mcp/dist/index.js"]
    }
  }
}