Connect your AI Agents to Microsoft Planner in minutes

Available tools
list_buckets
List all buckets in a Planner plan. Use list_plans to find valid plan IDs. Use cursor from page_info for next page.
get_bucket
Get a Planner bucket by ID. Use list_buckets to find valid bucket IDs.
create_bucket
Create a new bucket in a Planner plan to organize tasks. Use list_plans to find valid plan IDs.
update_bucket
Update a Planner bucket's name or order. Fetches current ETag automatically. Use list_buckets to find valid bucket IDs.
delete_bucket
Permanently delete a Planner bucket. The bucket must be empty (no tasks) before deletion. Fetches current ETag automatically. Use list_buckets to find valid bucket IDs.
list_todo_lists
List all Microsoft To Do lists for the current user. Use cursor from page_info for next page.
get_todo_list
Get a Microsoft To Do list by ID. Use list_todo_lists to find valid list IDs.
create_todo_list
Create a new Microsoft To Do list.
update_todo_list
Rename a Microsoft To Do list. Use list_todo_lists to find valid list IDs.
delete_todo_list
Permanently delete a Microsoft To Do list and all its tasks. Use list_todo_lists to find valid list IDs.
list_todo_tasks
List tasks in a Microsoft To Do list. Use list_todo_lists to find valid list IDs. Use cursor from page_info for next page.
get_todo_task
Get a Microsoft To Do task by ID. Use list_todo_tasks to find valid task IDs.
create_todo_task
Create a task in a Microsoft To Do list. Use list_todo_lists to find valid list IDs.
update_todo_task
Update a Microsoft To Do task. Use list_todo_tasks to find valid task IDs.
delete_todo_task
Permanently delete a Microsoft To Do task. Use list_todo_tasks to find valid task IDs.
list_todo_steps
List all checklist steps for a Microsoft To Do task. Use list_todo_tasks to find valid task IDs.
get_todo_step
Get a single checklist step from a Microsoft To Do task. Use list_todo_steps to find valid item IDs.
create_todo_step
Add a checklist step to a Microsoft To Do task. Use list_todo_tasks to find valid task IDs.
update_todo_step
Update a checklist step in a Microsoft To Do task. Use list_todo_steps to find valid item IDs.
delete_todo_step
Delete a checklist step from a Microsoft To Do task. Use list_todo_steps to find valid item IDs.
list_plans
List Planner plans. Omit group_id for current user's plans; provide group_id to list a M365 group's plans. Use cursor from page_info for next page.
get_plan
Get a Planner plan by ID. Use list_plans to find valid plan IDs.
get_plan_details
Get extended details for a Planner plan including shared users and category label names. Use list_plans to find valid plan IDs.
create_plan
Create a new Planner plan. Provide group_id to create under a M365 group, or omit to create a roster-based personal plan.
update_plan
Update a Planner plan's title. Fetches current ETag automatically. Use list_plans to find valid plan IDs.
delete_plan
Permanently delete a Planner plan and all its tasks and buckets. Fetches current ETag automatically. Use list_plans to find valid plan IDs.
list_tasks
List Planner tasks. Omit plan_id and bucket_id for current user's assigned tasks. Provide plan_id to list all tasks in a plan, or bucket_id to list tasks in a specific bucket. Use cursor from page_info for next page.
get_task
Get a Planner task by ID. Use list_tasks to find valid task IDs.
get_task_details
Get extended task details including description, checklist items, and external references. Use list_tasks to find valid task IDs.
create_task
Create a new task in a Planner plan. Use list_plans to find valid plan IDs, list_buckets to find bucket IDs.
update_task
Update a Planner task's title, bucket, due date, priority, or completion percentage. Fetches current ETag automatically. Use list_tasks to find valid task IDs.
update_task_details
Update a task's description, checklist items, or external references. Fetches current ETag automatically. Use list_tasks to find valid task IDs.
delete_task
Permanently delete a Planner task. Fetches current ETag automatically. Use list_tasks to find valid task IDs.
list_checklist_items
List all checklist items (todos) for a Planner task. Use list_tasks to find valid task IDs.
add_checklist_item
Add a checklist item (todo) to a Planner task. Use list_tasks to find valid task IDs.
update_checklist_item
Update a checklist item's title or checked state in a Planner task. Use list_checklist_items to find valid item IDs.
delete_checklist_item
Delete a checklist item from a Planner task. Use list_checklist_items to find valid item IDs.
validate_credential
Validate Microsoft Planner credentials by calling GET /me on Microsoft Graph.

How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Microsoft Planner MCP server
FAQs on using Merge's Microsoft Planner MCP server
What is a Microsoft Planner MCP?
It's an MCP server that connects your agents to Microsoft Planner via tools. Your agents can invoke these tools to create and assign tasks, organize work into buckets, update task progress, retrieve plan details, and more.
Microsoft doesn't offer an MCP server purpose built for Microsoft Planner, but you can use one from a third-party platform, like Merge Agent Handler.
How can I use the Microsoft Planner MCP server?
The use cases naturally depend on the agent you've built, but here are a few common ones:
- Automated task creation from external events: When a new support ticket is opened in Zendesk, an agent creates a corresponding task in Microsoft Planner, assigns it to the right team member, and sets a due date based on the ticket's priority level
- Sprint status digest: On a recurring schedule, an agent retrieves all tasks across a Planner plan, groups them by bucket and completion status, and posts a structured summary to a Microsoft Teams channel so the team has a current snapshot without opening Planner
- Cross-tool project kickoff: When a deal closes in Salesforce, an agent creates a new plan in Planner, populates it with a standard set of onboarding tasks, and assigns each task to the appropriate owner based on role
- Overdue task escalation: An agent scans open Planner tasks each morning, identifies items past their due date with no recent progress update, and posts a targeted reminder in Slack to each assigned team member
What are popular tools for Microsoft Planner's MCP server?
Here are some of the most commonly used tools:
list_plans: retrieves all Planner plans associated with a Microsoft 365 group. Useful for agents that need to identify which plan to target before creating or updating tasks
create_task: adds a new task to a specified plan and bucket with a title, due date, and assignee. Call this when an agent needs to create work items in response to events in other systems
get_task: fetches the full details of a single task including assignments, checklist items, and notes. Use this when an agent needs complete context on a task before modifying it or surfacing it in a report
update_task: modifies an existing task's fields such as percent complete, due date, or assigned users. Good for workflows that keep Planner tasks synchronized with status changes happening in external tools
list_tasks: retrieves all tasks in a plan, optionally filtered by bucket or assignee. Helpful when an agent needs to audit task distribution, generate a progress report, or identify overdue items
list_buckets: returns all buckets within a plan, providing the structural context an agent needs before routing new tasks to the correct category or stage
What makes Merge Agent Handler's Microsoft Planner MCP server better than alternative Microsoft Planner MCP servers?
Here is what sets Merge Agent Handler's Microsoft Planner MCP server apart from building your own or using a standalone alternative:
- Enterprise-grade security and DLP: Merge Agent Handler includes data loss prevention controls that filter specific fields before they reach an agent. For Microsoft Planner, this means task notes, attachments, and assignee details can be blocked at the tool layer even when the agent has broad plan access
- Managed authentication and credentials: Merge stores your Microsoft 365 OAuth credentials and handles token refresh automatically. You never pass raw credentials to an agent or coordinate re-authentication when tokens expire
- Real-time observability and audit trail: Every tool call made against Microsoft Planner is logged with timestamp, tool name, input parameters, and response metadata. You can see exactly which tasks an agent created, updated, or read without adding any custom instrumentation
- Tool Packs and controlled access: Tool Packs let you combine specific Microsoft Planner tools with tools from other connectors into a single scoped MCP endpoint. An agent gets exactly the operations it needs for a given workflow, nothing beyond that
How can I start using Merge Agent Handler's Microsoft Planner MCP server?
You can take the following steps (assuming you use Claude Code):
1. Create or log into your Merge Agent Handler account.
2. Install the Merge CLI by running pipx install merge-api, then run merge configure to link the CLI to your Merge account and merge login to authenticate your session.
3. Register the Agent Handler MCP server with Claude Code by running claude mcp add --transport http agent-handler https://ah-api.merge.dev/mcp, then open Claude Code and run /mcp to confirm agent-handler appears with a connected status.
4. Select agent-handler from the MCP list. This opens a browser window where you select which integrations to authenticate. Choose Microsoft Planner and complete the OAuth flow. Merge stores and manages the credentials going forward.
5. Open a Claude Code session and start querying Microsoft Planner data directly. The first time you use a Microsoft Planner tool, a Magic Link may appear to complete connector authentication.
If you want to connect Merge Agent Handler's Microsoft Planner MCP with internal or customer-facing agentic products, you can follow the steps in our docs.
Can employees use Merge Agent Handler to connect their AI tools to Microsoft Planner?
Yes, Agent Handler for Employees lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to Microsoft Planner without bypassing IT governance.
Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Agent Handler and gets individual credentials tied to their identity. A project manager can ask their AI to create tasks, check plan status, or reassign work across buckets, all within the permissions IT has defined.
IT also provisions access by role or group via SCIM. A project manager, for example, gets Microsoft Planner access to create and track tasks, Jira to log related engineering work, and Slack to coordinate team updates; while a team lead gets Microsoft Planner access to monitor plan progress, Asana to manage cross-team dependencies, and Microsoft Teams to report status to stakeholders.
Every tool call an employee's AI makes to Microsoft Planner is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now

























