Microsoft Planner

A lightweight MCP server that uses Azure CLI authentication to manage Planner plans, buckets, and tasks.

javascript

0

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You have a lightweight MCP server that lets Claude Code interact with Microsoft Planner tasks by using Azure CLI authentication. It avoids complex OAuth flows by leveraging the built-in az rest calls and az login state, enabling direct Graph API access to Planner data that your account can access.

How to use

Add the planner MCP server to your Claude Code integration or MCP settings, then run the server locally and point Claude Code at it. You can list plans, buckets, and tasks, create and update tasks, and fetch task details using natural language prompts. The server relies on your existing az login session for authentication, so ensure you are logged in to Azure CLI before starting.

How to install

Prerequisites: install Node.js v18 or later and ensure the Azure CLI is installed and you are logged in with az login.

Install steps you will follow exactly as shown:

# Clone the project
git clone https://github.com/vyente-ruffin/microsoft-planner-mcp.git
cd microsoft-planner-mcp

# Install dependencies
npm install

# Build the project
npm run build

Configuration and usage notes

The MCP server is intended to run locally and be invoked by Claude Code. You will typically start it from your environment and register it with Claude Code using the provided command. The server uses your current Azure CLI authentication state, so make sure you have run az login and have network access to Graph API endpoints.

Recommended workflow for Claude Code integration:

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

Or, add a configuration entry directly to your MCP settings with the same runtime target:

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

Finding your IDs

To use the MCP tools, you’ll need your Planner Plan IDs and Bucket IDs. Use the following flow to locate them:

list-plans
list-buckets --plan-id <PLAN_ID>
# Or derive PLAN_ID from the Planner web URL: https://tasks.office.com/...planId=YOUR_PLAN_ID

Available tools

list-plans

List all Planner plans accessible to the current user.

list-buckets

List all buckets within a specified Planner plan.

list-tasks

List all tasks in a specific Planner plan.

get-task

Retrieve details of a specific Planner task.

get-task-details

Fetch extended details for a task, including description and checklists.

create-task

Create a new task within a plan.

update-task

Update core task properties such as title, progress, assignments, and categories.

update-task-details

Update task description and supporting details (including GitHub links).

delete-task

Remove a Planner task.