Microsoft 365

Microsoft Graph MCP Server for Cloudflare Workers

Available Tools

98 tools available in the Microsoft 365 MCP server. Each tool can be called by AI assistants to perform specific actions.

microsoft_list_my_planner_tasks

List all Planner tasks assigned to me.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_list_planner_plans

List Planner plans for a group.

Args:

groupId: Group/Team ID

{
  "type": "object",
  "required": [
    "groupId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "groupId": {
      "type": "string",
      "description": "Group/Team ID"
    }
  }
}

microsoft_get_planner_plan

Get a Planner plan.

Args:

planId: Plan ID

{
  "type": "object",
  "required": [
    "planId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "planId": {
      "type": "string",
      "description": "Plan ID"
    }
  }
}

microsoft_move_message

Move a message to a different folder.

Args:

messageId: Message ID
destinationFolderId: Destination folder ID

{
  "type": "object",
  "required": [
    "messageId",
    "destinationFolderId"
  ],
  "properties": {
    "messageId": {
      "type": "string",
      "description": "Message ID"
    },
    "destinationFolderId": {
      "type": "string",
      "description": "Destination folder ID"
    }
  }
}

microsoft_delete_message

Delete an email message.

Args:

messageId: Message ID to delete

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "messageId": {
      "type": "string",
      "description": "Message ID"
    }
  }
}

microsoft_get_me

Get the current user's profile information.

Returns the authenticated user's profile including name, email, job title, and other details.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

microsoft_get_user

Get a user's profile by ID or UPN.

Args:

userId: User ID or userPrincipalName (email)

{
  "type": "object",
  "required": [
    "userId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID or userPrincipalName"
    }
  }
}

microsoft_list_users

List users in the organization.

Args:

top: Number of users to return (max 999)
filter: OData filter expression
select: Comma-separated list of properties to return

{
  "type": "object",
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 999,
      "minimum": 1,
      "description": "Number of users to return"
    },
    "filter": {
      "type": "string",
      "description": "OData filter expression"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "select": {
      "type": "string",
      "description": "Properties to return"
    }
  }
}

microsoft_get_manager

Get a user's manager.

Args:

userId: User ID (optional, defaults to current user)

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID (defaults to current user)"
    }
  }
}

microsoft_list_direct_reports

List a user's direct reports.

Args:

userId: User ID (optional, defaults to current user)

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "userId": {
      "type": "string",
      "description": "User ID (defaults to current user)"
    }
  }
}

microsoft_list_mail_folders

List mail folders (Inbox, Sent, Drafts, etc.).

{
  "type": "object",
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_list_messages

List email messages, optionally filtered by folder.

Args:

folderId: Mail folder ID (optional, defaults to all messages)
top: Number of messages to return
filter: OData filter expression
orderby: OData orderby expression

{
  "type": "object",
  "properties": {
    "top": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "filter": {
      "type": "string",
      "description": "OData filter (e.g., \"isRead eq false"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "orderby": {
      "type": "string",
      "description": "OData orderby (e.g., \"receivedDateTime desc"
    },
    "folderId": {
      "type": "string",
      "description": "Mail folder ID"
    }
  }
}

microsoft_get_message

Get a specific email message by ID.

Args:

messageId: Message ID

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID"
    }
  }
}

microsoft_send_mail

Send an email message.

Args:

to: Array of recipient email addresses
subject: Email subject
body: Email body content
cc: Array of CC recipients (optional)
bcc: Array of BCC recipients (optional)
importance: Message importance (low, normal, high)
bodyType: Body content type (text, html)
saveToSentItems: Whether to save to Sent Items

{
  "type": "object",
  "required": [
    "to",
    "subject",
    "body"
  ],
  "properties": {
    "cc": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "CC recipients"
    },
    "to": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Recipient email addresses"
    },
    "bcc": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "BCC recipients"
    },
    "body": {
      "type": "string",
      "description": "Email body"
    },
    "subject": {
      "type": "string",
      "description": "Email subject"
    },
    "bodyType": {
      "enum": [
        "text",
        "html"
      ],
      "type": "string",
      "default": "text"
    },
    "importance": {
      "enum": [
        "low",
        "normal",
        "high"
      ],
      "type": "string"
    },
    "saveToSentItems": {
      "type": "boolean"
    }
  }
}

microsoft_reply_to_message

Reply to an email message.

Args:

messageId: Message ID to reply to
comment: Reply text
replyAll: Whether to reply all (default: false)

{
  "type": "object",
  "required": [
    "messageId",
    "comment"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "description": "Reply text"
    },
    "replyAll": {
      "type": "boolean"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID"
    }
  }
}

microsoft_forward_message

Forward an email message.

Args:

messageId: Message ID to forward
to: Array of recipient email addresses
comment: Optional comment to include

{
  "type": "object",
  "required": [
    "messageId",
    "to"
  ],
  "properties": {
    "to": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Forward to addresses"
    },
    "comment": {
      "type": "string",
      "description": "Comment to include"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID"
    }
  }
}

microsoft_update_message

Update message properties (mark as read, add categories).

Args:

messageId: Message ID
isRead: Mark as read/unread
categories: Categories to assign

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "isRead": {
      "type": "boolean",
      "description": "Mark as read/unread"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Categories"
    }
  }
}

microsoft_list_attachments

List attachments for a message.

Args:

messageId: Message ID

{
  "type": "object",
  "required": [
    "messageId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID"
    }
  }
}

microsoft_create_mail_folder

Create a new mail folder.

Args:

displayName: Folder name
parentFolderId: Parent folder ID (optional)

{
  "type": "object",
  "required": [
    "displayName"
  ],
  "properties": {
    "displayName": {
      "type": "string",
      "description": "Folder name"
    },
    "parentFolderId": {
      "type": "string",
      "description": "Parent folder ID"
    }
  }
}

microsoft_list_calendars

List user's calendars.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_list_events

List calendar events.

Args:

calendarId: Calendar ID (optional, defaults to primary calendar)
startDateTime: Start of date range (ISO 8601)
endDateTime: End of date range (ISO 8601)
top: Number of events to return

{
  "type": "object",
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "calendarId": {
      "type": "string",
      "description": "Calendar ID"
    },
    "endDateTime": {
      "type": "string",
      "description": "End date (ISO 8601)"
    },
    "startDateTime": {
      "type": "string",
      "description": "Start date (ISO 8601)"
    }
  }
}

microsoft_get_event

Get a specific calendar event.

Args:

eventId: Event ID

{
  "type": "object",
  "required": [
    "eventId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "eventId": {
      "type": "string",
      "description": "Event ID"
    }
  }
}

microsoft_create_event

Create a calendar event.

Args:

subject: Event subject
startDateTime: Start date/time (ISO 8601)
startTimeZone: Start time zone
endDateTime: End date/time (ISO 8601)
endTimeZone: End time zone
attendees: Array of attendee emails
location: Event location
body: Event description
isOnlineMeeting: Create as Teams meeting

{
  "type": "object",
  "required": [
    "subject",
    "startDateTime",
    "endDateTime"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Description"
    },
    "subject": {
      "type": "string",
      "description": "Event subject"
    },
    "bodyType": {
      "enum": [
        "text",
        "html"
      ],
      "type": "string",
      "default": "text"
    },
    "location": {
      "type": "string",
      "description": "Location"
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Attendee emails"
    },
    "endDateTime": {
      "type": "string",
      "description": "End date/time (ISO 8601)"
    },
    "endTimeZone": {
      "type": "string",
      "default": "UTC",
      "description": "End time zone"
    },
    "startDateTime": {
      "type": "string",
      "description": "Start date/time (ISO 8601)"
    },
    "startTimeZone": {
      "type": "string",
      "default": "UTC",
      "description": "Start time zone"
    },
    "isOnlineMeeting": {
      "type": "boolean",
      "default": false,
      "description": "Create Teams meeting"
    },
    "reminderMinutesBeforeStart": {
      "type": "integer"
    }
  }
}

microsoft_update_event

Update a calendar event.

Args:

eventId: Event ID
subject: New subject
startDateTime/startTimeZone: New start
endDateTime/endTimeZone: New end
location: New location
body: New description

{
  "type": "object",
  "required": [
    "eventId"
  ],
  "properties": {
    "body": {
      "type": "string"
    },
    "eventId": {
      "type": "string",
      "description": "Event ID"
    },
    "subject": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "endDateTime": {
      "type": "string"
    },
    "endTimeZone": {
      "type": "string"
    },
    "startDateTime": {
      "type": "string"
    },
    "startTimeZone": {
      "type": "string"
    },
    "isOnlineMeeting": {
      "type": "boolean"
    }
  }
}

microsoft_delete_event

Delete a calendar event.

Args:

eventId: Event ID

{
  "type": "object",
  "required": [
    "eventId"
  ],
  "properties": {
    "eventId": {
      "type": "string",
      "description": "Event ID"
    }
  }
}

microsoft_respond_to_event

Respond to a calendar event invitation.

Args:

eventId: Event ID
response: accept, tentativelyAccept, or decline
comment: Optional comment

{
  "type": "object",
  "required": [
    "eventId",
    "response"
  ],
  "properties": {
    "comment": {
      "type": "string",
      "description": "Comment"
    },
    "eventId": {
      "type": "string",
      "description": "Event ID"
    },
    "response": {
      "enum": [
        "accept",
        "tentativelyAccept",
        "decline"
      ],
      "type": "string",
      "description": "Response"
    }
  }
}

microsoft_get_schedule_availability

Get free/busy availability for users.

Args:

schedules: Array of email addresses to check
startTime: Start of time range (ISO 8601)
endTime: End of time range (ISO 8601)
timeZone: Time zone

{
  "type": "object",
  "required": [
    "schedules",
    "startTime",
    "endTime"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "endTime": {
      "type": "string",
      "description": "End time (ISO 8601)"
    },
    "timeZone": {
      "type": "string",
      "default": "UTC"
    },
    "schedules": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Emails to check"
    },
    "startTime": {
      "type": "string",
      "description": "Start time (ISO 8601)"
    }
  }
}

microsoft_get_my_drive

Get the current user's OneDrive information.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_list_drive_items

List files and folders in OneDrive.

Args:

driveId: Drive ID (optional, defaults to user's drive)
folderId: Folder ID (optional, defaults to root)
top: Number of items to return

{
  "type": "object",
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "driveId": {
      "type": "string",
      "description": "Drive ID"
    },
    "folderId": {
      "type": "string",
      "description": "Folder ID"
    }
  }
}

microsoft_delete_page

Delete a OneNote page.

Args:

pageId: Page ID

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "pageId": {
      "type": "string",
      "description": "Page ID"
    }
  }
}

microsoft_get_drive_item

Get a file or folder by ID.

Args:

itemId: Item ID
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "itemId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "driveId": {
      "type": "string"
    }
  }
}

microsoft_get_drive_item_by_path

Get a file or folder by path.

Args:

path: Path relative to root (e.g., "Documents/report.docx")
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Path relative to root"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "driveId": {
      "type": "string"
    }
  }
}

microsoft_search_drive

Search for files in OneDrive.

Args:

query: Search query
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "driveId": {
      "type": "string"
    }
  }
}

microsoft_create_folder

Create a folder in OneDrive.

Args:

name: Folder name
parentId: Parent folder ID (optional, defaults to root)
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Folder name"
    },
    "driveId": {
      "type": "string"
    },
    "parentId": {
      "type": "string",
      "description": "Parent folder ID"
    }
  }
}

microsoft_upload_file

Upload a file to OneDrive (max 4MB for simple upload).

Args:

filename: File name
content: File content (text)
parentId: Parent folder ID (optional)
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "filename",
    "content"
  ],
  "properties": {
    "content": {
      "type": "string",
      "description": "File content"
    },
    "driveId": {
      "type": "string"
    },
    "filename": {
      "type": "string",
      "description": "File name"
    },
    "parentId": {
      "type": "string",
      "description": "Parent folder ID"
    }
  }
}

microsoft_download_file

Download a file's content.

Args:

itemId: Item ID
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "itemId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "driveId": {
      "type": "string"
    }
  }
}

microsoft_delete_drive_item

Delete a file or folder.

Args:

itemId: Item ID
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "itemId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "driveId": {
      "type": "string"
    }
  }
}

microsoft_copy_drive_item

Copy a file or folder.

Args:

itemId: Item ID to copy
destinationParentId: Destination folder ID
newName: New name (optional)
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "itemId",
    "destinationParentId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "driveId": {
      "type": "string"
    },
    "newName": {
      "type": "string",
      "description": "New name"
    },
    "destinationParentId": {
      "type": "string",
      "description": "Destination folder ID"
    }
  }
}

microsoft_move_drive_item

Move a file or folder.

Args:

itemId: Item ID to move
destinationParentId: Destination folder ID
newName: New name (optional)
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "itemId",
    "destinationParentId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "driveId": {
      "type": "string"
    },
    "newName": {
      "type": "string",
      "description": "New name"
    },
    "destinationParentId": {
      "type": "string",
      "description": "Destination folder ID"
    }
  }
}

microsoft_create_share_link

Create a sharing link for a file or folder.

Args:

itemId: Item ID
type: Link type (view or edit)
scope: Link scope (anonymous or organization)
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "itemId",
    "type"
  ],
  "properties": {
    "type": {
      "enum": [
        "view",
        "edit"
      ],
      "type": "string",
      "description": "Link type"
    },
    "scope": {
      "enum": [
        "anonymous",
        "organization"
      ],
      "type": "string",
      "default": "organization"
    },
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "driveId": {
      "type": "string"
    }
  }
}

microsoft_list_permissions

List sharing permissions for a file or folder.

Args:

itemId: Item ID
driveId: Drive ID (optional)

{
  "type": "object",
  "required": [
    "itemId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "driveId": {
      "type": "string"
    }
  }
}

microsoft_list_joined_teams

List teams the current user has joined.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_get_team

Get team details.

Args:

teamId: Team ID

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

microsoft_list_channels

List channels in a team.

Args:

teamId: Team ID

{
  "type": "object",
  "required": [
    "teamId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    }
  }
}

microsoft_list_channel_messages

List messages in a channel.

Args:

teamId: Team ID
channelId: Channel ID
top: Number of messages to return

{
  "type": "object",
  "required": [
    "teamId",
    "channelId"
  ],
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    }
  }
}

microsoft_send_channel_message

Send a message to a channel.

Args:

teamId: Team ID
channelId: Channel ID
content: Message content
contentType: Content type (text or html)

{
  "type": "object",
  "required": [
    "teamId",
    "channelId",
    "content"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "content": {
      "type": "string",
      "description": "Message content"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "contentType": {
      "enum": [
        "text",
        "html"
      ],
      "type": "string"
    }
  }
}

microsoft_reply_to_channel_message

Reply to a channel message.

Args:

teamId: Team ID
channelId: Channel ID
messageId: Message ID to reply to
content: Reply content
contentType: Content type

{
  "type": "object",
  "required": [
    "teamId",
    "channelId",
    "messageId",
    "content"
  ],
  "properties": {
    "teamId": {
      "type": "string",
      "description": "Team ID"
    },
    "content": {
      "type": "string",
      "description": "Reply content"
    },
    "channelId": {
      "type": "string",
      "description": "Channel ID"
    },
    "messageId": {
      "type": "string",
      "description": "Message ID"
    },
    "contentType": {
      "enum": [
        "text",
        "html"
      ],
      "type": "string"
    }
  }
}

microsoft_list_chats

List user's chats.

{
  "type": "object",
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_list_chat_messages

List messages in a chat.

Args:

chatId: Chat ID
top: Number of messages to return

{
  "type": "object",
  "required": [
    "chatId"
  ],
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "chatId": {
      "type": "string",
      "description": "Chat ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_send_chat_message

Send a message in a chat.

Args:

chatId: Chat ID
content: Message content
contentType: Content type

{
  "type": "object",
  "required": [
    "chatId",
    "content"
  ],
  "properties": {
    "chatId": {
      "type": "string",
      "description": "Chat ID"
    },
    "content": {
      "type": "string",
      "description": "Message content"
    },
    "contentType": {
      "enum": [
        "text",
        "html"
      ],
      "type": "string"
    }
  }
}

microsoft_create_online_meeting

Create a Teams online meeting.

Args:

subject: Meeting subject
startDateTime: Start date/time (ISO 8601)
endDateTime: End date/time (ISO 8601)
attendees: Array of attendee emails

{
  "type": "object",
  "required": [
    "subject",
    "startDateTime",
    "endDateTime"
  ],
  "properties": {
    "subject": {
      "type": "string",
      "description": "Meeting subject"
    },
    "attendees": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "endDateTime": {
      "type": "string",
      "description": "End date/time (ISO 8601)"
    },
    "startDateTime": {
      "type": "string",
      "description": "Start date/time (ISO 8601)"
    }
  }
}

microsoft_list_contacts

List Outlook contacts.

{
  "type": "object",
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "filter": {
      "type": "string",
      "description": "OData filter"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_get_contact

Get a contact by ID.

Args:

contactId: Contact ID

{
  "type": "object",
  "required": [
    "contactId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "contactId": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

microsoft_create_contact

Create a new Outlook contact.

Args:

givenName: First name
surname: Last name
emailAddress: Email address
businessPhone: Business phone
mobilePhone: Mobile phone
companyName: Company name
jobTitle: Job title

{
  "type": "object",
  "properties": {
    "surname": {
      "type": "string"
    },
    "jobTitle": {
      "type": "string"
    },
    "givenName": {
      "type": "string"
    },
    "companyName": {
      "type": "string"
    },
    "mobilePhone": {
      "type": "string"
    },
    "emailAddress": {
      "type": "string"
    },
    "businessPhone": {
      "type": "string"
    }
  }
}

microsoft_update_contact

Update a contact.

Args:

contactId: Contact ID
givenName, surname, etc.: Fields to update

{
  "type": "object",
  "required": [
    "contactId"
  ],
  "properties": {
    "surname": {
      "type": "string"
    },
    "jobTitle": {
      "type": "string"
    },
    "contactId": {
      "type": "string",
      "description": "Contact ID"
    },
    "givenName": {
      "type": "string"
    },
    "companyName": {
      "type": "string"
    },
    "mobilePhone": {
      "type": "string"
    },
    "emailAddress": {
      "type": "string"
    },
    "businessPhone": {
      "type": "string"
    }
  }
}

microsoft_delete_contact

Delete a contact.

Args:

contactId: Contact ID

{
  "type": "object",
  "required": [
    "contactId"
  ],
  "properties": {
    "contactId": {
      "type": "string",
      "description": "Contact ID"
    }
  }
}

microsoft_list_contact_folders

List contact folders.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_list_task_lists

List To Do task lists.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_create_task_list

Create a new task list.

Args:

displayName: List name

{
  "type": "object",
  "required": [
    "displayName"
  ],
  "properties": {
    "displayName": {
      "type": "string",
      "description": "List name"
    }
  }
}

microsoft_delete_task_list

Delete a task list.

Args:

listId: List ID

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "List ID"
    }
  }
}

microsoft_list_tasks

List tasks in a task list.

Args:

listId: Task list ID
top: Number of tasks to return

{
  "type": "object",
  "required": [
    "listId"
  ],
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Task list ID"
    }
  }
}

microsoft_get_task

Get a task by ID.

Args:

listId: Task list ID
taskId: Task ID

{
  "type": "object",
  "required": [
    "listId",
    "taskId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Task list ID"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

microsoft_create_task

Create a new task.

Args:

listId: Task list ID
title: Task title
body: Task body/notes
importance: low, normal, high
dueDateTime: Due date (ISO 8601)
dueTimeZone: Time zone

{
  "type": "object",
  "required": [
    "listId",
    "title"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Task body"
    },
    "title": {
      "type": "string",
      "description": "Task title"
    },
    "listId": {
      "type": "string",
      "description": "Task list ID"
    },
    "importance": {
      "enum": [
        "low",
        "normal",
        "high"
      ],
      "type": "string"
    },
    "dueDateTime": {
      "type": "string",
      "description": "Due date (ISO 8601)"
    },
    "dueTimeZone": {
      "type": "string"
    }
  }
}

microsoft_update_task

Update a task.

Args:

listId: Task list ID
taskId: Task ID
title, body, importance, status, dueDateTime: Fields to update

{
  "type": "object",
  "required": [
    "listId",
    "taskId"
  ],
  "properties": {
    "body": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Task list ID"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "importance": {
      "enum": [
        "low",
        "normal",
        "high"
      ],
      "type": "string"
    },
    "dueDateTime": {
      "type": "string"
    },
    "dueTimeZone": {
      "type": "string"
    }
  }
}

microsoft_delete_task

Delete a task.

Args:

listId: Task list ID
taskId: Task ID

{
  "type": "object",
  "required": [
    "listId",
    "taskId"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Task list ID"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

microsoft_list_checklist_items

List checklist items for a task.

Args:

listId: Task list ID
taskId: Task ID

{
  "type": "object",
  "required": [
    "listId",
    "taskId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "Task list ID"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

microsoft_create_checklist_item

Create a checklist item.

Args:

listId: Task list ID
taskId: Task ID
displayName: Item name

{
  "type": "object",
  "required": [
    "listId",
    "taskId",
    "displayName"
  ],
  "properties": {
    "listId": {
      "type": "string",
      "description": "Task list ID"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "displayName": {
      "type": "string",
      "description": "Item name"
    }
  }
}

microsoft_update_checklist_item

Update a checklist item.

Args:

listId: Task list ID
taskId: Task ID
itemId: Checklist item ID
displayName: New name
isChecked: Checked state

{
  "type": "object",
  "required": [
    "listId",
    "taskId",
    "itemId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "description": "Checklist item ID"
    },
    "listId": {
      "type": "string",
      "description": "Task list ID"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "isChecked": {
      "type": "boolean"
    },
    "displayName": {
      "type": "string"
    }
  }
}

microsoft_list_planner_tasks

List tasks in a Planner plan.

Args:

planId: Plan ID

{
  "type": "object",
  "required": [
    "planId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "planId": {
      "type": "string",
      "description": "Plan ID"
    }
  }
}

microsoft_get_planner_task

Get a Planner task.

Args:

taskId: Task ID

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

microsoft_create_planner_task

Create a Planner task.

Args:

planId: Plan ID
title: Task title
bucketId: Bucket ID (optional)
dueDateTime: Due date (ISO 8601, optional)

{
  "type": "object",
  "required": [
    "planId",
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Task title"
    },
    "planId": {
      "type": "string",
      "description": "Plan ID"
    },
    "bucketId": {
      "type": "string",
      "description": "Bucket ID"
    },
    "dueDateTime": {
      "type": "string",
      "description": "Due date (ISO 8601)"
    }
  }
}

microsoft_update_planner_task

Update a Planner task.

Args:

taskId: Task ID
etag: ETag for concurrency (from task's @odata.etag)
title, percentComplete, dueDateTime, bucketId: Fields to update

{
  "type": "object",
  "required": [
    "taskId",
    "etag"
  ],
  "properties": {
    "etag": {
      "type": "string",
      "description": "ETag from task"
    },
    "title": {
      "type": "string"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    },
    "bucketId": {
      "type": "string"
    },
    "dueDateTime": {
      "type": "string"
    },
    "percentComplete": {
      "type": "integer",
      "maximum": 100,
      "minimum": 0
    }
  }
}

microsoft_delete_planner_task

Delete a Planner task.

Args:

taskId: Task ID
etag: ETag for concurrency

{
  "type": "object",
  "required": [
    "taskId",
    "etag"
  ],
  "properties": {
    "etag": {
      "type": "string",
      "description": "ETag from task"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

microsoft_list_planner_buckets

List buckets in a plan.

Args:

planId: Plan ID

{
  "type": "object",
  "required": [
    "planId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "planId": {
      "type": "string",
      "description": "Plan ID"
    }
  }
}

microsoft_create_planner_bucket

Create a bucket in a plan.

Args:

planId: Plan ID
name: Bucket name

{
  "type": "object",
  "required": [
    "planId",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Bucket name"
    },
    "planId": {
      "type": "string",
      "description": "Plan ID"
    }
  }
}

microsoft_get_planner_task_details

Get task details including description and checklist.

Args:

taskId: Task ID

{
  "type": "object",
  "required": [
    "taskId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "taskId": {
      "type": "string",
      "description": "Task ID"
    }
  }
}

microsoft_get_root_site

Get the organization's root SharePoint site.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_get_site

Get a SharePoint site by ID.

Args:

siteId: Site ID or path (e.g., "contoso.sharepoint.com:/sites/team")

{
  "type": "object",
  "required": [
    "siteId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID or path"
    }
  }
}

microsoft_search_sites

Search for SharePoint sites.

Args:

query: Search query

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_list_site_lists

List SharePoint lists in a site.

Args:

siteId: Site ID

{
  "type": "object",
  "required": [
    "siteId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID"
    }
  }
}

microsoft_get_list

Get a SharePoint list.

Args:

siteId: Site ID
listId: List ID

{
  "type": "object",
  "required": [
    "siteId",
    "listId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID"
    }
  }
}

microsoft_list_list_items

List items in a SharePoint list.

Args:

siteId: Site ID
listId: List ID
top: Number of items to return

{
  "type": "object",
  "required": [
    "siteId",
    "listId"
  ],
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID"
    }
  }
}

microsoft_get_list_item

Get a SharePoint list item.

Args:

siteId: Site ID
listId: List ID
itemId: Item ID

{
  "type": "object",
  "required": [
    "siteId",
    "listId",
    "itemId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID"
    }
  }
}

microsoft_create_list_item

Create a SharePoint list item.

Args:

siteId: Site ID
listId: List ID
fields: JSON object with field values

{
  "type": "object",
  "required": [
    "siteId",
    "listId",
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "JSON object with field values"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID"
    }
  }
}

microsoft_update_list_item

Update a SharePoint list item.

Args:

siteId: Site ID
listId: List ID
itemId: Item ID
fields: JSON object with field values to update

{
  "type": "object",
  "required": [
    "siteId",
    "listId",
    "itemId",
    "fields"
  ],
  "properties": {
    "fields": {
      "type": "string",
      "description": "JSON object with field values"
    },
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID"
    }
  }
}

microsoft_delete_list_item

Delete a SharePoint list item.

Args:

siteId: Site ID
listId: List ID
itemId: Item ID

{
  "type": "object",
  "required": [
    "siteId",
    "listId",
    "itemId"
  ],
  "properties": {
    "itemId": {
      "type": "string",
      "description": "Item ID"
    },
    "listId": {
      "type": "string",
      "description": "List ID"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID"
    }
  }
}

microsoft_get_site_drive

Get the document library drive for a site.

Args:

siteId: Site ID

{
  "type": "object",
  "required": [
    "siteId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "siteId": {
      "type": "string",
      "description": "Site ID"
    }
  }
}

microsoft_list_notebooks

List OneNote notebooks.

{
  "type": "object",
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

microsoft_get_notebook

Get a OneNote notebook.

Args:

notebookId: Notebook ID

{
  "type": "object",
  "required": [
    "notebookId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "notebookId": {
      "type": "string",
      "description": "Notebook ID"
    }
  }
}

microsoft_create_notebook

Create a OneNote notebook.

Args:

displayName: Notebook name

{
  "type": "object",
  "required": [
    "displayName"
  ],
  "properties": {
    "displayName": {
      "type": "string",
      "description": "Notebook name"
    }
  }
}

microsoft_list_sections

List sections in a notebook.

Args:

notebookId: Notebook ID

{
  "type": "object",
  "required": [
    "notebookId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "notebookId": {
      "type": "string",
      "description": "Notebook ID"
    }
  }
}

microsoft_get_section

Get a OneNote section.

Args:

sectionId: Section ID

{
  "type": "object",
  "required": [
    "sectionId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sectionId": {
      "type": "string",
      "description": "Section ID"
    }
  }
}

microsoft_create_section

Create a section in a notebook.

Args:

notebookId: Notebook ID
displayName: Section name

{
  "type": "object",
  "required": [
    "notebookId",
    "displayName"
  ],
  "properties": {
    "notebookId": {
      "type": "string",
      "description": "Notebook ID"
    },
    "displayName": {
      "type": "string",
      "description": "Section name"
    }
  }
}

microsoft_list_section_groups

List section groups in a notebook.

Args:

notebookId: Notebook ID

{
  "type": "object",
  "required": [
    "notebookId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "notebookId": {
      "type": "string",
      "description": "Notebook ID"
    }
  }
}

microsoft_list_pages

List pages in a section.

Args:

sectionId: Section ID
top: Number of pages to return

{
  "type": "object",
  "required": [
    "sectionId"
  ],
  "properties": {
    "top": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "sectionId": {
      "type": "string",
      "description": "Section ID"
    }
  }
}

microsoft_get_page

Get a OneNote page metadata.

Args:

pageId: Page ID

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "pageId": {
      "type": "string",
      "description": "Page ID"
    }
  }
}

microsoft_get_page_content

Get the HTML content of a OneNote page.

Args:

pageId: Page ID

{
  "type": "object",
  "required": [
    "pageId"
  ],
  "properties": {
    "pageId": {
      "type": "string",
      "description": "Page ID"
    }
  }
}

microsoft_create_page

Create a OneNote page.

Args:

sectionId: Section ID
title: Page title
htmlContent: HTML content for the page body

{
  "type": "object",
  "required": [
    "sectionId",
    "htmlContent"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Page title"
    },
    "sectionId": {
      "type": "string",
      "description": "Section ID"
    },
    "htmlContent": {
      "type": "string",
      "description": "HTML content"
    }
  }
}