Skip to Content

Outlook Mail

Service domainEMAIL
Outlook Mail icon
Arcade Optimized

Arcade.dev LLM tools for Outlook Mail

Author:Arcade
Version:2.4.2
Auth:User authorization via the Microsoft auth provider
9tools
PyPI VersionPython VersionsWheel StatusDownloadsLicense

Outlook Mail Toolkit Overview\nThe Arcade.dev Outlook Mail toolkit provides powerful functionalities to integrate Outlook Mail capabilities into applications. It enables developers to manage email interactions seamlessly through a variety of tools and features.\n\nCapabilities\n- Create, send, and draft emails with ease.\n- List and filter emails across all mailbox folders.\n- Reply to emails and manage draft updates effectively.\n- Retrieve comprehensive user profile and configuration details.\n\nOAuth\n- Provider: Microsoft\n- Scopes: Mail.Read, Mail.ReadWrite, Mail.Send, User.Read\n\nSecrets\nNo secrets are required for usage.

Available tools(9)

9 of 9 tools
Operations
Behavior
Tool nameDescriptionSecrets
Create and immediately send a new email in Outlook to the specified recipients
Compose a new draft email in Outlook
List emails in the user's mailbox across all folders. Since this tool lists email across all folders, it may return sent items, drafts, and other items that are not in the inbox.
List emails in the user's mailbox across all folders filtering by a property.
List the user's emails in the specified folder. Exactly one of `well_known_folder_name` or `folder_id` MUST be provided.
Reply to an existing email in Outlook. Use this tool to reply to the sender or all recipients of the email. Specify the reply_type to determine the scope of the reply.
Send an existing draft email in Outlook This tool can send any un-sent email: - draft - reply-draft - reply-all draft - forward draft
Update an existing draft email in Outlook. This tool overwrites the subject and body of a draft email (if provided), and modifies its recipient lists by selectively adding or removing email addresses. This tool can update any un-sent email: - draft - reply-draft - reply-all draft - forward draft
Get comprehensive user profile and Outlook Mail environment information. This tool provides detailed information about the authenticated user including their name, email, mailbox settings, automatic replies configuration, and other important profile details from Outlook Mail services.

Selected tools

No tools selected.

Click "Show all tools" to add tools.

Requirements

Select tools to see requirements

#

OutlookMail.CreateAndSendEmail

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
Email
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Create and immediately send a new email in Outlook to the specified recipients

Parameters

ParameterTypeReq.Description
subjectstringRequiredThe subject of the email to create
bodystringRequiredThe body of the email to create
to_recipientsarray<string>RequiredThe email addresses that will be the recipients of the email
cc_recipientsarray<string>OptionalThe email addresses that will be the CC recipients of the email.
bcc_recipientsarray<string>OptionalThe email addresses that will be the BCC recipients of the email.
body_typestringOptionalThe content type of the email body. Defaults to 'text'
texthtml

Requirements

No secrets required

Output

Type:jsonA dictionary containing the created email details
#

OutlookMail.CreateDraftEmail

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
Email
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Compose a new draft email in Outlook

Parameters

ParameterTypeReq.Description
subjectstringRequiredThe subject of the draft email to create
bodystringRequiredThe body of the draft email to create
to_recipientsarray<string>RequiredThe email addresses that will be the recipients of the draft email
cc_recipientsarray<string>OptionalThe email addresses that will be the CC recipients of the draft email.
bcc_recipientsarray<string>OptionalThe email addresses that will be the BCC recipients of the draft email.
body_typestringOptionalThe content type of the email body. Defaults to 'text'
texthtml

Requirements

No secrets required

Output

Type:jsonA dictionary containing the created email details
#

OutlookMail.ListEmails

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Email
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

List emails in the user's mailbox across all folders. Since this tool lists email across all folders, it may return sent items, drafts, and other items that are not in the inbox.

Parameters

ParameterTypeReq.Description
limitintegerOptionalThe number of messages to return. Max is 100. Defaults to 5.
pagination_tokenstringOptionalThe pagination token to continue a previous request

Requirements

No secrets required

Output

Type:jsonA dictionary containing a list of emails
#

OutlookMail.ListEmailsByProperty

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Email
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

List emails in the user's mailbox across all folders filtering by a property.

Parameters

ParameterTypeReq.Description
propertystringRequiredThe property to filter the emails by.
subjectconversationIdreceivedDateTimesender/emailAddress/address
operatorstringRequiredThe operator to use for the filter.
eqnegtgeltlestartsWithendsWithcontains
valuestringRequiredThe value to filter the emails by
limitintegerOptionalThe number of messages to return. Max is 100. Defaults to 5.
pagination_tokenstringOptionalThe pagination token to continue a previous request

Requirements

No secrets required

Output

Type:jsonA dictionary containing a list of emails
#

OutlookMail.ListEmailsInFolder

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Email
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

List the user's emails in the specified folder. Exactly one of `well_known_folder_name` or `folder_id` MUST be provided.

Parameters

ParameterTypeReq.Description
well_known_folder_namestringOptionalThe name of the folder to list emails from. Defaults to None.
deleteditemsdraftsinboxjunkemailsentitemsstarredtasks
folder_idstringOptionalThe ID of the folder to list emails from if the folder is not a well-known folder. Defaults to None.
limitintegerOptionalThe number of messages to return. Max is 100. Defaults to 5.
pagination_tokenstringOptionalThe pagination token to continue a previous request

Requirements

No secrets required

Output

Type:jsonA dictionary containing a list of emails and a pagination token, if applicable
#

OutlookMail.ReplyToEmail

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
Email
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Reply to an existing email in Outlook. Use this tool to reply to the sender or all recipients of the email. Specify the reply_type to determine the scope of the reply.

Parameters

ParameterTypeReq.Description
message_idstringRequiredThe ID of the email to reply to
bodystringRequiredThe body of the reply to the email
reply_typestringOptionalSpecify ReplyType.REPLY to reply only to the sender or ReplyType.REPLY_ALL to reply to all recipients. Defaults to ReplyType.REPLY.
replyreply_all

Requirements

No secrets required

Output

Type:jsonA dictionary containing the sent email details
#

OutlookMail.SendDraftEmail

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
Email
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Send an existing draft email in Outlook This tool can send any un-sent email: - draft - reply-draft - reply-all draft - forward draft

Parameters

ParameterTypeReq.Description
message_idstringRequiredThe ID of the draft email to send

Requirements

No secrets required

Output

Type:jsonA dictionary containing the sent email details
#

OutlookMail.UpdateDraftEmail

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Update
Service domains
Email
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Update an existing draft email in Outlook. This tool overwrites the subject and body of a draft email (if provided), and modifies its recipient lists by selectively adding or removing email addresses. This tool can update any un-sent email: - draft - reply-draft - reply-all draft - forward draft

Parameters

ParameterTypeReq.Description
message_idstringRequiredThe ID of the draft email to update
subjectstringOptionalThe new subject of the draft email. If provided, the existing subject will be overwritten
bodystringOptionalThe new body of the draft email. If provided, the existing body will be overwritten
to_addarray<string>OptionalEmail addresses to add as 'To' recipients.
to_removearray<string>OptionalEmail addresses to remove from the current 'To' recipients.
cc_addarray<string>OptionalEmail addresses to add as 'CC' recipients.
cc_removearray<string>OptionalEmail addresses to remove from the current 'CC' recipients.
bcc_addarray<string>OptionalEmail addresses to add as 'BCC' recipients.
bcc_removearray<string>OptionalEmail addresses to remove from the current 'BCC' recipients.

Requirements

No secrets required

Output

Type:jsonA dictionary containing the updated email details
#

OutlookMail.WhoAmI

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Email
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Get comprehensive user profile and Outlook Mail environment information. This tool provides detailed information about the authenticated user including their name, email, mailbox settings, automatic replies configuration, and other important profile details from Outlook Mail services.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:jsonGet comprehensive user profile and Outlook Mail environment information.
Last updated on