update-contact-folder
update-contact-folderRename or move a Microsoft 365 contact folder by updating its display name or parent folder ID, directly through the Graph API.
Instructions
Update the properties of contactfolder object.
š” TIP: Updates a contact folder. Body: { displayName?: 'New name', parentFolderId?: '' } ā both displayName (rename) and parentFolderId (move) are writable. The default 'Contacts' folder may not be renameable. Get the folder id via list-contact-folders.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"body": "<body>",
"contactFolderId": "<contactFolderId>"
},
"name": "update-contact-folder"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | ||
| confirm | No | For destructive operations when the confirm gate is enabled (MS365_MCP_REQUIRE_CONFIRM=true; off by default). Set to true only after the user has explicitly approved this action. When the gate is on, calls without confirm: true return { error: "confirmation_required" } without touching user data. | |
| includeHeaders | No | Include response headers (including ETag) in the response metadata | |
| contactFolderId | Yes | Value for the 'contactFolderId' path segment. Pass it under the name 'contactFolderId', not as 'id'. Use the 'id' field of the contact folder object as returned by Microsoft Graph. | |
| excludeResponse | No | Exclude the full response body and only return success or failure indication |