Skip to content
MCP server

Microsoft Planner

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.4.0
Listing updated
4 days ago

About Microsoft Planner

Microsoft Planner is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add mcp-planner --env MS_TENANT_ID='<MS_TENANT_ID>' --env MS_CLIENT_ID='<MS_CLIENT_ID>' --env MS_CLIENT_SECRET='<MS_CLIENT_SECRET>' -- npx -y mcp-planner

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-planner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-planner"
      ],
      "env": {
        "MS_TENANT_ID": "<MS_TENANT_ID>",
        "MS_CLIENT_ID": "<MS_CLIENT_ID>",
        "MS_CLIENT_SECRET": "<MS_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-planner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-planner"
      ],
      "env": {
        "MS_TENANT_ID": "<MS_TENANT_ID>",
        "MS_CLIENT_ID": "<MS_CLIENT_ID>",
        "MS_CLIENT_SECRET": "<MS_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-planner": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-planner"
      ],
      "env": {
        "MS_TENANT_ID": "<MS_TENANT_ID>",
        "MS_CLIENT_ID": "<MS_CLIENT_ID>",
        "MS_CLIENT_SECRET": "<MS_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-planner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-planner"
      ],
      "env": {
        "MS_TENANT_ID": "<MS_TENANT_ID>",
        "MS_CLIENT_ID": "<MS_CLIENT_ID>",
        "MS_CLIENT_SECRET": "<MS_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-planner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-planner"
      ],
      "env": {
        "MS_TENANT_ID": "<MS_TENANT_ID>",
        "MS_CLIENT_ID": "<MS_CLIENT_ID>",
        "MS_CLIENT_SECRET": "<MS_CLIENT_SECRET>"
      }
    }
  }
}

Configuration

  • MS_TENANT_IDMicrosoft Entra ID tenant id (GUID or domain)Required
  • MS_CLIENT_IDEntra app registration client idRequired
  • MS_CLIENT_SECRETEntra app registration client secret (app needs Tasks.ReadWrite.All, GroupMember.Read.All, User.Read.All application permissions)Required
  • PLANNER_ADVANCED_TOOLSETtrue/1 registers the advanced toolset (graph_get, graph_find_endpoint) — a read-only escape hatch limited to /planner, /groups, /users

Pricing

Open source

Microsoft Planner FAQ

Is Microsoft Planner free?

Yes. Microsoft Planner is open source, so you can use and self-host it for free.

How do I add Microsoft Planner to Claude Code?

Run this command in your terminal: claude mcp add mcp-planner --env MS_TENANT_ID='<MS_TENANT_ID>' --env MS_CLIENT_ID='<MS_CLIENT_ID>' --env MS_CLIENT_SECRET='<MS_CLIENT_SECRET>' -- npx -y mcp-planner