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
Explore other MCP servers built and managed by Merge
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
