Microsoft Planner MCP

This is an unofficial, community/open-source MCP server for Microsoft Planner.
It is not affiliated with, endorsed by, or sponsored by Microsoft.

Once connected, you can ask your AI assistant things like:

- "Show me all my Planner tasks that are overdue"
- "Create a task called 'Prepare Q3 report' in the Marketing plan"
- "Move all incomplete tasks in the Sprint bucket to the Backlog bucket"
- "Mark the 'Update docs' task as complete"

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

Note: This MCP only supports Planner basic tasks and plans

To run the server locally you also need:

- 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 forlist_userstool)
- Go toExpose an API
- Set theApplication ID URI(accept the defaultapi://<client-id>or customise it)
- ClickAdd a scope:

- Scope name:mcp-access
- Who can consent:Admins and users(orAdmins onlyif you prefer)
- Fill in the display name and description
- Set state toEnabled
- Go toManifest(orAuthentication→Advanced settingsin newer portal versions)
- Set"requestedAccessTokenVersion"to2
- Save
- Go toCertificates & secrets→New client secret
- Add a description and choose an expiry period
- Copy theValueimmediately (it is only shown once)

You will need these three values for configuration:

git clone https://github.com/aixolotl/microsoft-planner-mcp cd microsoft-planner-mcp uv sync

Copy the example environment file and fill in your Azure credentials:

Once the server is running, configure your MCP client to connect to it.

Add the following to your VS Code settings (.vscode/settings.jsonin your project, or your user settings):

{ "mcp": { "servers": { "planner": { "type": "http", "url": "http://localhost:8000/mcp" } } } }

Then use Copilot Chat inAgent modeand ask it to interact with your Planner tasks. Copilot will discover the available tools automatically.

Any client that supports theStreamable HTTPtransport can connect by pointing tohttp://localhost:8000/mcp. The server advertises OAuth metadata automatically — the client handles the authentication flow.

All tools are available to your AI assistant automatically once connected. You don't need to call them directly — just describe what you want in natural language. The parameter details below are provided for reference and for client developers.

Read-only tools are annotated withreadOnlyHint: trueso clients can skip confirmation prompts. Destructive tools (deletes) are annotated withdestructiveHint: true.

Return the authenticated user's profile from Microsoft Graph.

- Parameters:None
- Returns:User profile object (id, displayName, mail, etc.) ornull

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 display names.

Note:When bothguids/emailsandsearchare supplied, the GUID/email filter takes priority. Very large lists of GUIDs or e-mail addresses are silently truncated to stay within the 2 048-character Graph URL limit.

List all Microsoft 365 groups the authenticated user is a member of.

Note:The Groups tool will not return details like name or mail of groups with the standard permissionsTasks.ReadWritedocumented here,howeversearching and filtering still works, so you can find a group with a specific name using this tool.

List Planner plans shared with the authenticated user.

List all Planner plans belonging to a Microsoft 365 group.

Create a new Planner plan for a Microsoft 365 group.

- Returns:The created plan object ornull

Get category label definitions for a Planner plan. Returns all 25 category slots with their key (e.g.category1) and display name.

- Returns:List of category objects (key,display_name) ornull

- Returns:The created bucket object ornull

List all Planner tasks assigned to the authenticated user across all plans.

Get the full details for a task: description, checklist items, and external references.

- Returns:Task details object (description, checklist, references) ornull

- Returns:The created task object ornull

Update a task's standard fields and/or detail fields (description, checklist, references). Only provided fields are changed. When detail fields are specified, a separate API call updates the task details resource automatically.

- Returns:The updated task object, the updated task details object, or both ({ "task": ..., "details": ... }) depending on which fields were provided. Returnsnullif the result is empty.

Note:Theupdate_task_detailstool has been removed. Useupdate_taskwith detail field parameters (description,checklistItems,references,previewType) instead. The task and details resources have separate ETags — provideetagDetailswhen available to avoid an extra round-trip, or omit it to let the tool auto-refresh.

Return metadata for every field on a Planner task, including its data type, description, whether it is writable, and whether it requires a separateget_task_detailscall.

- Parameters:None
- Returns:List of field metadata objects (name,type,description,writable,detailed)

Note:The list of fields is static as Planner Standard doesn't support custom fields. But this endpoint awaits Microsoft's future updates to the API to fully support Planner Premium.

This section covers building, testing, and contributing to the project.

src/ ├── server.py # FastMCP app, middleware, route mounting ├── config.py # Settings via pydantic-settings ├── auth_provider.py # Azure OAuth provider (OBO flow) ├── deps.py # Shared dependency helpers ├── graph_client_manager.py # Singleton GraphClientManager with per-user OBO clients ├── telemetry.py # OpenTelemetry setup ├── types.py # Shared structural types ├── services/ │ └── planner_service.py # Business logic wrapping Graph SDK calls └── tools/ ├── me.py # get_me ├── groups.py # list_my_groups ├── plans.py # plan tools + list_plan_categories ├── tasks.py # task tools + list_task_fields └── buckets.py # bucket tools tests/ ├── conftest.py ├── test_buckets_tool.py ├── test_groups_tool.py ├── test_planner_service.py ├── test_plans_tool.py └── test_tasks_tool.py

# Install the optional OTEL dependency group uv sync --group otel # Set the OTLP endpoint and start the server export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317 export OTEL_SERVICE_NAME=microsoft-planner-mcp uv run uvicorn src.server:app --host 0.0.0.0 --port 8000

uv run uvicorn src.server:app --host 0.0.0.0 --port 8000

Open the URL printed in the terminal (e.g.http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=...)

SetTransport TypetoStreamable HTTPandURLtohttp://localhost:8000/mcp, then clickConnect.

Interact with task, doc, and project data in Dart, an AI-native project management tool

Remote MCP server for MeisterTask. Create and manage projects, tasks, and notes from your AI assistant. Hosted (streamable-HTTP) — connect at https://mcp.meistertask.com/mcp

The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.