Microsoft Planner MCP Server

The AI assistant translates your request into the appropriate tool calls automatically.

Local serverstdioPython

What is the Microsoft Planner MCP MCP server?

The AI assistant translates your request into the appropriate tool calls automatically. The microsoft planner mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.

Its toolset

Everything the assistant can do here goes through one of these:

  • Tasks.ReadWrite — read and write Planner tasks
  • User.Read — read the signed-in user's profile
  • User.ReadBasic.All — resolve user display names from the GUIDs in task assignments (required only for list_users tool)
  • Local — The MCP endpoint is available at http://localhost:8000/mcp. A health check endpoint is at http://localhost:8000/health
  • User — The User tool exposed by this server
  • get_me — Return the authenticated user's profile from Microsoft Graph
  • list_users — Retrieve Microsoft 365 users by GUID, e-mail address, or free-text search. Useful for resolving the user GUIDs returned in task assignment objects to
  • Groups — The Groups tool exposed by this server
  • list_my_groups — List all Microsoft 365 groups the authenticated user is a member of
  • Plans — The Plans tool exposed by this server
  • list_my_plans — The list_my_plans tool exposed by this server
  • list_group_plans — The list_group_plans tool exposed by this server

Configuration

You will need 7 environment variables: OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_SERVICE_NAME, CLIENT_ID, CLIENT_SECRET, TENANT_ID, BASE_URL, MCP_PROXY_AUTH_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • A Microsoft 365 account with access to Microsoft Planner - An Azure Entra ID (Azure AD) app registration (see Azure Setup below) - An MCP-compatible client — for example: - VS Code - Claude Desktop To run the server locally you also need: - Python 3.12+ -

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at @modelcontextprotocol/inspector on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

When to reach for it

Plenty of planning and project tracking servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Microsoft Planner MCP's toolset — Tasks.ReadWrite, User.Read, User.ReadBasic.All and 11 more — is a fair guide to whether it matches your workflow. It is maintained by aixolotl; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Microsoft Planner MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the microsoft planner mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
Tasks.ReadWriteread and write Planner tasks
User.Readread the signed-in user's profile
User.ReadBasic.Allresolve user display names from the GUIDs in task assignments (required only for list_users tool)
LocalThe MCP endpoint is available at http://localhost:8000/mcp. A health check endpoint is at http://localhost:8000/health.
UserThe User tool exposed by this server.
get_meReturn the authenticated user's profile from Microsoft Graph.
list_usersRetrieve Microsoft 365 users by GUID, e-mail address, or free-text search. Useful for resolving the user GUIDs returned in task assignment objects to display names.
GroupsThe Groups tool exposed by this server.
list_my_groupsList all Microsoft 365 groups the authenticated user is a member of.
PlansThe Plans tool exposed by this server.
list_my_plansThe list_my_plans tool exposed by this server.
list_group_plansThe list_group_plans tool exposed by this server.
create_planThe create_plan tool exposed by this server.
delete_planThe delete_plan tool exposed by this server.

How to install the Microsoft Planner MCP MCP server

{
  "mcpServers": {
    "microsoft-planner": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/inspector"],
      "env": {
        "OTEL_EXPORTER_OTLP_ENDPOINT": "your-value",
        "OTEL_SERVICE_NAME": "your-value",
        "CLIENT_ID": "your-value",
        "CLIENT_SECRET": "your-value",
        "TENANT_ID": "your-value",
        "BASE_URL": "your-value",
        "MCP_PROXY_AUTH_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • A Microsoft 365 account with access to Microsoft Planner - An Azure Entra ID (Azure AD) app registration (see Azure Setup below) - An MCP-compatible client — for example: - VS Code - Claude Desktop To run the server locally you also need: - Python 3.12+ -
VariableDescriptionRequired
OTEL_EXPORTER_OTLP_ENDPOINTConfiguration value read at startup.Optional
OTEL_SERVICE_NAMEConfiguration value read at startup.Optional
CLIENT_IDConfiguration value read at startup.Optional
CLIENT_SECRETCredential the server authenticates with.Yes
TENANT_IDConfiguration value read at startup.Optional
BASE_URLEndpoint or connection string the server talks to.Yes
MCP_PROXY_AUTH_TOKENCredential the server authenticates with.Yes

Example prompts to try

  • Use Microsoft Planner MCP to Tasks.ReadWrite.
  • Use Microsoft Planner MCP to User.Read.
  • Use Microsoft Planner MCP to User.ReadBasic.All.

Frequently asked questions

It connects Microsoft Planner MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Tasks.ReadWrite, User.Read, User.ReadBasic.All, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Microsoft Planner MCP directly.