Outlook connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Set up the connector

   Register your Outlook credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

   Dashboard setup steps

   Register your Scalekit environment with the Outlook connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:

   1. Create the Outlook connection in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections > Create Connection. Search for Outlook and click Create.

        

      • In the Configure Outlook Connection dialog, copy the Redirect URI. You will need this when registering your app in Azure.

        

   2. Register an application in Azure

      • Sign into portal.azure.com and go to Microsoft Entra ID → App registrations.

        

      • Click New registration. Enter a name for your app (for example, “Scalekit Outlook Connector”).

      • Under Supported account types, select Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts.

      • Under Redirect URI, select Web and paste the redirect URI you copied from the Scalekit dashboard. Click Register.

        

   3. Get your client credentials

      • From the app’s Overview page, copy the Application (client) ID.

        

      • Go to Certificates & secrets in the left sidebar, then click + New client secret.

        

      • Enter a description (for example, “Secret for Scalekit Agent Actions”), set an expiry period, and click Add. Copy the secret Value immediately — it is only shown once.

        

   4. Add credentials in Scalekit

      • In Scalekit dashboard, go to AgentKit > Connections and open the Outlook connection you created.

      • Enter your credentials:

        • Client ID — the Application (client) ID from the Azure app overview
        • Client Secret — the secret value from Certificates & secrets
        • Scopes — select the permissions your app needs (for example, Calendars.Read, Calendars.ReadWrite, Mail.Read, Mail.ReadWrite, Mail.Send, Contacts.Read, Contacts.ReadWrite, User.Read, offline_access). See Microsoft Graph permissions reference for the full list.

      • Click Save.

4. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'outlook'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Outlook:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'outlook_list_calendar_events',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "outlook"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Outlook:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="outlook_list_calendar_events",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update message rule, message, mail folder — Update an existing inbox message rule
• Event tentatively accept, forward, decline — Tentatively accept a calendar event invitation
• Search people, messages — Search for people relevant to the signed-in user by name or email
• Message move, reply to — Move a message to a different mail folder
• List shared calendar events, message rules, mail folders — Retrieve calendar events from another user shared calendar
• Get user presence, mail tips, contact — Get the presence status of a specific user

Common workflows

Proxy API call

Node.js

const result = await actions.request({
  connectionName: 'outlook',
  identifier: 'user_123',
  path: '/v1.0/me/messages',
  method: 'GET',
});
console.log(result);

Python

result = actions.request(
    connection_name='outlook',
    identifier='user_123',
    path="/v1.0/me/messages",
    method="GET"
)
print(result)

Execute a tool

Node.js

const result = await actions.executeTool({
  connector: 'outlook',
  identifier: 'user_123',
  toolName: 'outlook_create_calendar_event',
  toolInput: {},
});
console.log(result);

Python

result = actions.execute_tool(
    connection_name='outlook',
    identifier='user_123',
    tool_name='outlook_create_calendar_event',
    tool_input={},
)
print(result)

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

outlook_accept_event # Accept a calendar event invitation. 5 params ▾

Accept a calendar event invitation.

Name Type Required Description

event_id string required Event ID.

comment string optional Response comment.

schema_version string optional Schema version

send_response boolean optional Send response.

tool_version string optional Tool version

outlook_create_calendar_event # Create a new calendar event in the user's Outlook calendar. Supports attendees, recurrence, reminders, online meetings, multiple locations, and event properties. 28 params ▾

Create a new calendar event in the user's Outlook calendar. Supports attendees, recurrence, reminders, online meetings, multiple locations, and event properties.

Name Type Required Description

end_datetime string required No description.

end_timezone string required No description.

start_datetime string required No description.

start_timezone string required No description.

subject string required No description.

attendees_optional string optional Array of email addresses for optional attendees

attendees_required string optional Array of email addresses for required attendees

attendees_resource string optional Array of email addresses for resources (meeting rooms, equipment)

body_content string optional No description.

body_contentType string optional No description.

hideAttendees boolean optional When true, each attendee only sees themselves

importance string optional Event importance level

isAllDay boolean optional Mark as all-day event

isOnlineMeeting boolean optional Create an online meeting (Teams/Skype)

isReminderOn boolean optional Enable or disable reminder

location string optional No description.

locations string optional JSON array of location objects with displayName, address, coordinates

onlineMeetingProvider string optional Online meeting provider

recurrence_days_of_week string optional Days of week for weekly recurrence (comma-separated)

recurrence_end_date string optional End date for recurrence (YYYY-MM-DD), required if range_type is endDate

recurrence_interval integer optional How often the event recurs (e.g., every 2 weeks = 2)

recurrence_occurrences integer optional Number of occurrences, required if range_type is numbered

recurrence_range_type string optional How the recurrence ends

recurrence_start_date string optional Start date for recurrence (YYYY-MM-DD)

recurrence_type string optional Recurrence pattern type

reminderMinutesBeforeStart integer optional Minutes before event start to show reminder

sensitivity string optional Event sensitivity/privacy level

showAs string optional Free/busy status

outlook_create_contact # Create a new contact in the user's mailbox with name, email addresses, and phone numbers. 7 params ▾

Create a new contact in the user's mailbox with name, email addresses, and phone numbers.

Name Type Required Description

givenName string required First name of the contact

surname string required Last name of the contact

businessPhones array optional Array of business phone numbers

companyName string optional Company name

emailAddresses array optional Array of email address objects with 'address' and optional 'name' fields

jobTitle string optional Job title

mobilePhone string optional Mobile phone number

outlook_create_draft_message # Create a new email draft in the mailbox. 9 params ▾

Create a new email draft in the mailbox.

Name Type Required Description

bcc_recipients string optional BCC recipients.

body string optional Email body content.

body_type string optional Body content type.

cc_recipients string optional CC recipients.

importance string optional Importance.

schema_version string optional Schema version

subject string optional Email subject.

to_recipients string optional To recipients.

tool_version string optional Tool version

outlook_create_forward_draft # Create a forward draft for a specific message. 5 params ▾

Create a forward draft for a specific message.

Name Type Required Description

message_id string required Message ID.

comment string optional Forward comment.

schema_version string optional Schema version

to_recipients string optional To recipients.

tool_version string optional Tool version

outlook_create_mail_folder # Create a new mail folder in the mailbox. 4 params ▾

Create a new mail folder in the mailbox.

Name Type Required Description

display_name string required Folder name.

is_hidden boolean optional Hidden folder.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_create_message_rule # Create a new inbox message rule. 8 params ▾

Create a new inbox message rule.

Name Type Required Description

display_name string required Rule name.

actions object optional Rule actions.

conditions object optional Rule conditions.

exceptions object optional Exception conditions for the rule.

is_enabled boolean optional Enable rule.

schema_version string optional Schema version

sequence integer optional Rule sequence.

tool_version string optional Tool version

outlook_create_reply_all_draft # Create a reply-all draft for a specific message. 4 params ▾

Create a reply-all draft for a specific message.

Name Type Required Description

message_id string required Message ID.

comment string optional Reply comment.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_create_reply_draft # Create a reply draft for a specific message. 4 params ▾

Create a reply draft for a specific message.

Name Type Required Description

message_id string required Message ID.

comment string optional Reply comment.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_decline_event # Decline a calendar event invitation. 6 params ▾

Decline a calendar event invitation.

Name Type Required Description

event_id string required Event ID.

comment string optional Response comment.

proposed_new_time object optional Proposed new meeting time.

schema_version string optional Schema version

send_response boolean optional Send response.

tool_version string optional Tool version

outlook_delete_calendar_event # Delete a calendar event by ID. 1 param ▾

Delete a calendar event by ID.

Name Type Required Description

event_id string required No description.

outlook_delete_contact # Permanently delete a contact. 3 params ▾

Permanently delete a contact.

Name Type Required Description

contact_id string required Contact ID.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_delete_mail_folder # Permanently delete a mail folder and its contents. 3 params ▾

Permanently delete a mail folder and its contents.

Name Type Required Description

folder_id string required Folder ID.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_delete_message # Permanently delete an email message. 3 params ▾

Permanently delete an email message.

Name Type Required Description

message_id string required Message ID.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_delete_message_rule # Delete an inbox message rule. 3 params ▾

Delete an inbox message rule.

Name Type Required Description

rule_id string required Rule ID.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_forward_event # Forward a calendar event to other people. 5 params ▾

Forward a calendar event to other people.

Name Type Required Description

comment string required Forward comment.

event_id string required Event ID.

to_recipients string required To recipients.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_get_attachment # Download a specific attachment from an Outlook email message by attachment ID. Returns the full attachment including base64-encoded file content in the contentBytes field. Use List Attachments to get the attachment ID first. 2 params ▾

Download a specific attachment from an Outlook email message by attachment ID. Returns the full attachment including base64-encoded file content in the contentBytes field. Use List Attachments to get the attachment ID first.

Name Type Required Description

attachment_id string required The ID of the attachment to download.

message_id string required The ID of the message containing the attachment.

outlook_get_calendar_event # Retrieve an existing calendar event by ID from the user's Outlook calendar. 1 param ▾

Retrieve an existing calendar event by ID from the user's Outlook calendar.

Name Type Required Description

event_id string required No description.

outlook_get_contact # Retrieve a specific contact by ID. 5 params ▾

Retrieve a specific contact by ID.

Name Type Required Description

contact_id string required Contact ID.

expand string optional Expand relationships.

schema_version string optional Schema version

select string optional Select properties.

tool_version string optional Tool version

outlook_get_mail_tips # Get mail tips for a list of recipients before sending an email. 4 params ▾

Get mail tips for a list of recipients before sending an email.

Name Type Required Description

email_addresses array required Recipient email addresses.

mail_tips_options string required Mail tip types.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_get_message # Retrieve a specific email message by ID from the user's Outlook mailbox, including full body content, sender, recipients, attachments info, and metadata. 1 param ▾

Retrieve a specific email message by ID from the user's Outlook mailbox, including full body content, sender, recipients, attachments info, and metadata.

Name Type Required Description

message_id string required The ID of the message to retrieve.

outlook_get_user_presence # Get the presence status of a specific user. 3 params ▾

Get the presence status of a specific user.

Name Type Required Description

user_id string required User ID or email.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_list_attachments # List all attachments on a specific Outlook email message. Returns attachment metadata including ID, name, size, and content type. Use the attachment ID with Get Attachment to download the file content. 1 param ▾

List all attachments on a specific Outlook email message. Returns attachment metadata including ID, name, size, and content type. Use the attachment ID with Get Attachment to download the file content.

Name Type Required Description

message_id string required The ID of the message to list attachments for.

outlook_list_calendar_events # List calendar events from the user's Outlook calendar with filtering, sorting, pagination, and field selection. 5 params ▾

List calendar events from the user's Outlook calendar with filtering, sorting, pagination, and field selection.

Name Type Required Description

filter string optional OData filter expression to filter events (e.g., startsWith(subject,'All'))

orderby string optional OData orderby expression to sort events (e.g., start/dateTime desc)

select string optional Comma-separated list of properties to include in the response

skip number optional Number of events to skip for pagination

top number optional Maximum number of events to return

outlook_list_calendars # Retrieve all calendars in the user mailbox. 4 params ▾

Retrieve all calendars in the user mailbox.

Name Type Required Description

schema_version string optional Schema version

skip integer optional Skip count.

tool_version string optional Tool version

top integer optional Page size.

outlook_list_contacts # List all contacts in the user's mailbox with support for filtering, pagination, and field selection. 5 params ▾

List all contacts in the user's mailbox with support for filtering, pagination, and field selection.

Name Type Required Description

$filter string optional Filter expression to narrow results (e.g., "emailAddresses/any(a:a/address eq 'user@example.com')")

$orderby string optional Property to sort by (e.g., "displayName")

$select string optional Comma-separated list of properties to return (e.g., "displayName,emailAddresses,phoneNumbers")

$skip integer optional Number of contacts to skip for pagination

$top integer optional Number of contacts to return (default: 10)

outlook_list_mail_folders # List all mail folders in the user mailbox. 5 params ▾

List all mail folders in the user mailbox.

Name Type Required Description

include_hidden boolean optional Include hidden folders.

schema_version string optional Schema version

skip integer optional Skip count.

tool_version string optional Tool version

top integer optional Page size.

outlook_list_message_rules # List all inbox message rules for the user. 2 params ▾

List all inbox message rules for the user.

Name Type Required Description

schema_version string optional Schema version

tool_version string optional Tool version

outlook_list_messages # List all messages in the user's mailbox with support for filtering, pagination, and field selection. Returns 10 messages by default. 5 params ▾

List all messages in the user's mailbox with support for filtering, pagination, and field selection. Returns 10 messages by default.

Name Type Required Description

$filter string optional Filter expression to narrow results (e.g., "from/emailAddress/address eq 'user@example.com'")

$orderby string optional Property to sort by (e.g., "receivedDateTime desc")

$select string optional Comma-separated list of properties to return (e.g., "subject,from,receivedDateTime")

$skip integer optional Number of messages to skip for pagination

$top integer optional Number of messages to return (1-1000, default: 10)

outlook_list_shared_calendar_events # Retrieve calendar events from another user shared calendar. 6 params ▾

Retrieve calendar events from another user shared calendar.

Name Type Required Description

end_date_time string required End date/time.

start_date_time string required Start date/time.

user_id string required User ID or email.

schema_version string optional Schema version

tool_version string optional Tool version

top integer optional Page size.

outlook_mailbox_settings_get # Retrieve the mailbox settings for the signed-in user. Returns automatic replies (out-of-office) configuration, language, timezone, working hours, date/time format, and delegate meeting message delivery preferences. 0 params ▾

Retrieve the mailbox settings for the signed-in user. Returns automatic replies (out-of-office) configuration, language, timezone, working hours, date/time format, and delegate meeting message delivery preferences.

outlook_mailbox_settings_update # Update mailbox settings for the signed-in user. Supports configuring automatic replies (out-of-office), language, timezone, working hours, date/time format, and delegate meeting message delivery preferences. Only fields provided will be updated. 7 params ▾

Update mailbox settings for the signed-in user. Supports configuring automatic replies (out-of-office), language, timezone, working hours, date/time format, and delegate meeting message delivery preferences. Only fields provided will be updated.

Name Type Required Description

automaticRepliesSetting object optional Configuration for automatic replies (out-of-office). Set status, internal/external reply messages, and optional scheduled time window.

dateFormat string optional Preferred date format string for the mailbox (e.g., 'MM/dd/yyyy', 'dd/MM/yyyy', 'yyyy-MM-dd').

delegateMeetingMessageDeliveryOptions string optional Controls how meeting messages are delivered when a delegate is configured.

language object optional Language and locale for the mailbox. Object with locale (e.g., 'en-US') and displayName.

timeFormat string optional Preferred time format string for the mailbox (e.g., 'hh:mm tt' for 12-hour, 'HH:mm' for 24-hour).

timeZone string optional Preferred time zone for the mailbox (e.g., 'UTC', 'Pacific Standard Time', 'Eastern Standard Time').

workingHours object optional Working hours configuration including days of week, start/end times, and time zone.

outlook_move_message # Move a message to a different mail folder. 4 params ▾

Move a message to a different mail folder.

Name Type Required Description

destination_id string required Destination folder ID.

message_id string required Message ID.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_reply_to_message # Reply to an existing email message. The reply is automatically sent to the original sender and saved in the Sent Items folder. 2 params ▾

Reply to an existing email message. The reply is automatically sent to the original sender and saved in the Sent Items folder.

Name Type Required Description

comment string required Reply message content

messageId string required The unique identifier of the message to reply to

outlook_search_messages # Search messages by keywords across subject, body, sender, and other fields. Returns matching messages with support for pagination. 4 params ▾

Search messages by keywords across subject, body, sender, and other fields. Returns matching messages with support for pagination.

Name Type Required Description

query string required Search query string (searches across subject, body, from, to)

$select string optional Comma-separated list of properties to return (e.g., "subject,from,receivedDateTime")

$skip integer optional Number of messages to skip for pagination

$top integer optional Number of messages to return (1-1000, default: 10)

outlook_search_people # Search for people relevant to the signed-in user by name or email. 8 params ▾

Search for people relevant to the signed-in user by name or email.

Name Type Required Description

filter string optional OData filter.

order_by string optional Order by field.

schema_version string optional Schema version

search string optional Search query.

select string optional Select properties.

skip integer optional Skip count.

tool_version string optional Tool version

top integer optional Page size.

outlook_send_message # Send an email message using Microsoft Graph API. The message is saved in the Sent Items folder by default. 7 params ▾

Send an email message using Microsoft Graph API. The message is saved in the Sent Items folder by default.

Name Type Required Description

body string required Body content of the email

subject string required Subject line of the email

toRecipients array required Array of email addresses to send to

bccRecipients array optional Array of email addresses to BCC

bodyType string optional Content type of the body (Text or HTML)

ccRecipients array optional Array of email addresses to CC

saveToSentItems boolean optional Save the message in Sent Items folder (default: true)

outlook_tentatively_accept_event # Tentatively accept a calendar event invitation. 6 params ▾

Tentatively accept a calendar event invitation.

Name Type Required Description

event_id string required Event ID.

comment string optional Response comment.

proposed_new_time object optional Proposed new meeting time.

schema_version string optional Schema version

send_response boolean optional Send response.

tool_version string optional Tool version

outlook_todo_checklist_items_create # Add a checklist item (subtask) to a specific task in a Microsoft To Do task list. 4 params ▾

Add a checklist item (subtask) to a specific task in a Microsoft To Do task list.

Name Type Required Description

display_name string required The display name of the checklist item.

list_id string required The ID of the task list.

task_id string required The ID of the task to add the checklist item to.

is_checked boolean optional Whether the checklist item is already checked/completed.

outlook_todo_checklist_items_delete # Permanently delete a checklist item (subtask) from a task in a Microsoft To Do task list. 3 params ▾

Permanently delete a checklist item (subtask) from a task in a Microsoft To Do task list.

Name Type Required Description

checklist_item_id string required The ID of the checklist item to delete.

list_id string required The ID of the task list.

task_id string required The ID of the task.

outlook_todo_checklist_items_get # Get a specific checklist item (subtask) from a task in a Microsoft To Do task list. 3 params ▾

Get a specific checklist item (subtask) from a task in a Microsoft To Do task list.

Name Type Required Description

checklist_item_id string required The ID of the checklist item.

list_id string required The ID of the task list.

task_id string required The ID of the task.

outlook_todo_checklist_items_list # List all checklist items (subtasks) for a specific task in a Microsoft To Do task list. 2 params ▾

List all checklist items (subtasks) for a specific task in a Microsoft To Do task list.

Name Type Required Description

list_id string required The ID of the task list.

task_id string required The ID of the task.

outlook_todo_checklist_items_update # Update a checklist item (subtask) in a Microsoft To Do task. Only provided fields are changed. 5 params ▾

Update a checklist item (subtask) in a Microsoft To Do task. Only provided fields are changed.

Name Type Required Description

checklist_item_id string required The ID of the checklist item to update.

list_id string required The ID of the task list.

task_id string required The ID of the task.

display_name string optional New display name for the checklist item.

is_checked boolean optional Whether the checklist item is checked/completed.

outlook_todo_lists_create # Create a new Microsoft To Do task list. 1 param ▾

Create a new Microsoft To Do task list.

Name Type Required Description

display_name string required The name of the task list.

outlook_todo_lists_delete # Permanently delete a Microsoft To Do task list and all its tasks. 1 param ▾

Permanently delete a Microsoft To Do task list and all its tasks.

Name Type Required Description

list_id string required The ID of the task list to delete.

outlook_todo_lists_get # Get a specific Microsoft To Do task list by ID. 1 param ▾

Get a specific Microsoft To Do task list by ID.

Name Type Required Description

list_id string required The ID of the task list.

outlook_todo_lists_list # List all Microsoft To Do task lists for the current user. 0 params ▾

List all Microsoft To Do task lists for the current user.

outlook_todo_lists_update # Rename a Microsoft To Do task list. 2 params ▾

Rename a Microsoft To Do task list.

Name Type Required Description

display_name string required The new name for the task list.

list_id string required The ID of the task list to update.

outlook_todo_tasks_create # Create a new task in a Microsoft To Do task list with optional body, due date, importance, and reminder. 10 params ▾

Create a new task in a Microsoft To Do task list with optional body, due date, importance, and reminder.

Name Type Required Description

list_id string required The ID of the task list to add the task to.

title string required The title of the task.

body string optional The body/notes of the task (plain text).

categories array optional Array of category names to assign to the task.

due_date string optional Due date in YYYY-MM-DD format (e.g. "2026-04-15").

due_time_zone string optional Time zone for the due date (e.g. "UTC", "America/New_York"). Defaults to UTC.

importance string optional The importance of the task: low, normal, or high.

reminder_date_time string optional Reminder date and time in ISO 8601 format (e.g. "2026-04-15T09:00:00").

reminder_time_zone string optional Time zone for the reminder (e.g. "UTC"). Defaults to UTC.

status string optional The status of the task: notStarted, inProgress, completed, waitingOnOthers, or deferred.

outlook_todo_tasks_delete # Permanently delete a task from a Microsoft To Do task list. 2 params ▾

Permanently delete a task from a Microsoft To Do task list.

Name Type Required Description

list_id string required The ID of the task list.

task_id string required The ID of the task to delete.

outlook_todo_tasks_get # Get a specific task from a Microsoft To Do task list. 2 params ▾

Get a specific task from a Microsoft To Do task list.

Name Type Required Description

list_id string required The ID of the task list.

task_id string required The ID of the task.

outlook_todo_tasks_list # List all tasks in a Microsoft To Do task list with optional filtering and pagination. 5 params ▾

List all tasks in a Microsoft To Do task list with optional filtering and pagination.

Name Type Required Description

list_id string required The ID of the task list.

$filter string optional OData filter expression (e.g. "status eq 'notStarted'").

$orderby string optional Property to sort by (e.g. "createdDateTime desc").

$skip integer optional Number of tasks to skip for pagination.

$top integer optional Number of tasks to return (default: 10).

outlook_todo_tasks_update # Update a task in a Microsoft To Do task list. Only provided fields are changed. 9 params ▾

Update a task in a Microsoft To Do task list. Only provided fields are changed.

Name Type Required Description

list_id string required The ID of the task list.

task_id string required The ID of the task to update.

body string optional New body/notes for the task (plain text).

categories array optional Array of category names to assign to the task.

due_date string optional Due date in YYYY-MM-DD format.

due_time_zone string optional Time zone for the due date. Defaults to UTC.

importance string optional The importance: low, normal, or high.

status string optional The status: notStarted, inProgress, completed, waitingOnOthers, or deferred.

title string optional New title for the task.

outlook_update_calendar_event # Update an existing Outlook calendar event. Only provided fields will be updated. Supports time, attendees, location, reminders, online meetings, recurrence, and event properties. 30 params ▾

Update an existing Outlook calendar event. Only provided fields will be updated. Supports time, attendees, location, reminders, online meetings, recurrence, and event properties.

Name Type Required Description

event_id string required The ID of the calendar event to update

attendees_optional string optional Comma-separated optional attendee emails

attendees_required string optional Comma-separated required attendee emails

attendees_resource string optional Comma-separated resource emails (meeting rooms, equipment)

body_content string optional Event description/body

body_contentType string optional Content type of body

categories string optional Comma-separated categories

end_datetime string optional Event end time in RFC3339 format

end_timezone string optional Timezone for end time

hideAttendees boolean optional When true, each attendee only sees themselves

importance string optional Event importance level

isAllDay boolean optional Mark as all-day event

isOnlineMeeting boolean optional Create an online meeting (Teams/Skype)

isReminderOn boolean optional Enable or disable reminder

location string optional Physical or virtual location

locations string optional JSON array of location objects with displayName, address, coordinates

onlineMeetingProvider string optional Online meeting provider

recurrence_days_of_week string optional Days of week for weekly recurrence (comma-separated)

recurrence_end_date string optional End date for recurrence (YYYY-MM-DD)

recurrence_interval integer optional How often the event recurs (e.g., every 2 weeks = 2)

recurrence_occurrences integer optional Number of occurrences

recurrence_range_type string optional How the recurrence ends

recurrence_start_date string optional Start date for recurrence (YYYY-MM-DD)

recurrence_type string optional Recurrence pattern type

reminderMinutesBeforeStart integer optional Minutes before event start to show reminder

sensitivity string optional Event sensitivity/privacy level

showAs string optional Free/busy status

start_datetime string optional Event start time in RFC3339 format

start_timezone string optional Timezone for start time

subject string optional Event title/summary

outlook_update_contact # Update properties of an existing contact. 9 params ▾

Update properties of an existing contact.

Name Type Required Description

contact_id string required Contact ID.

company_name string optional Company name.

email_addresses string optional Email addresses.

given_name string optional First name.

job_title string optional Job title.

mobile_phone string optional Mobile phone.

schema_version string optional Schema version

surname string optional Last name.

tool_version string optional Tool version

outlook_update_mail_folder # Rename or update a mail folder. 4 params ▾

Rename or update a mail folder.

Name Type Required Description

display_name string required New folder name.

folder_id string required Folder ID.

schema_version string optional Schema version

tool_version string optional Tool version

outlook_update_message # Update properties of an email message (e.g. mark as read, set importance). 12 params ▾

Update properties of an email message (e.g. mark as read, set importance).

Name Type Required Description

message_id string required Message ID.

body string optional Message body content.

body_content_type string optional Body content type.

categories array optional Categories.

importance string optional Importance.

inference_classification string optional Inference classification.

is_delivery_receipt_requested boolean optional Delivery receipt requested.

is_read boolean optional Mark as read.

is_read_receipt_requested boolean optional Read receipt requested.

schema_version string optional Schema version

subject string optional Updated subject.

tool_version string optional Tool version

outlook_update_message_rule # Update an existing inbox message rule. 10 params ▾

Update an existing inbox message rule.

Name Type Required Description

rule_id string required Rule ID.

actions object optional Rule actions.

conditions object optional Rule conditions.

display_name string optional Rule name.

exceptions object optional Exception conditions for the rule.

is_enabled boolean optional Enable rule.

is_read_only boolean optional Mark rule as read-only.

schema_version string optional Schema version

sequence integer optional Rule sequence.

tool_version string optional Tool version