arcade-mcp/toolkits/microsoft/arcade_microsoft/outlook_mail/_utils.py
Eric Gustin ef886bb503
Microsoft Outlook Mail Tools (#377)
| Name | Description |

|------------------------------|--------------------------------------------------------------------------------|
| Microsoft.CreateDraftEmail | Compose a new draft email in Outlook |
| Microsoft.UpdateDraftEmail | Update an existing draft email in Outlook
|
| Microsoft.CreateAndSendEmail | Create and immediately send a new email
in Outlook to the specified recipients |
| Microsoft.SendDraftEmail | Send an existing draft email in Outlook |
| Microsoft.ReplyToEmail | Reply only to the sender of an existing email
in Outlook |
| Microsoft.ReplyAllToEmail | Reply to all recipients of an existing
email in Outlook |
| Microsoft.ListEmails | List emails in the user's mailbox across all
folders |
| Microsoft.ListEmailsInFolder | List the user's emails in the specified
folder |
2025-04-24 14:27:52 -07:00

77 lines
3.1 KiB
Python

from arcade.sdk import ToolContext
from msgraph.generated.models.message_collection_response import MessageCollectionResponse
from msgraph.generated.users.item.mail_folders.item.messages.messages_request_builder import (
MessagesRequestBuilder as MailFolderMessagesRequestBuilder,
)
from msgraph.generated.users.item.messages.item.reply.reply_post_request_body import (
ReplyPostRequestBody,
)
from msgraph.generated.users.item.messages.item.reply_all.reply_all_post_request_body import (
ReplyAllPostRequestBody,
)
from msgraph.generated.users.item.messages.messages_request_builder import (
MessagesRequestBuilder as UserMessagesRequestBuilder,
)
from arcade_microsoft.client import get_client
from arcade_microsoft.outlook_mail.constants import DEFAULT_MESSAGE_FIELDS
from arcade_microsoft.outlook_mail.enums import ReplyType
def remove_none_values(data: dict) -> dict:
"""Remove all keys with None values from the dictionary."""
return {k: v for k, v in data.items() if v is not None}
def prepare_list_emails_request_config(
limit: int,
) -> MailFolderMessagesRequestBuilder.MessagesRequestBuilderGetRequestConfiguration:
limit = max(1, min(limit, 100)) # limit must be between 1 and 100
"""Prepare a request configuration for listing emails."""
query_params = MailFolderMessagesRequestBuilder.MessagesRequestBuilderGetQueryParameters(
count=True,
select=DEFAULT_MESSAGE_FIELDS,
orderby=["receivedDateTime DESC"],
top=limit,
)
return MailFolderMessagesRequestBuilder.MessagesRequestBuilderGetRequestConfiguration(
query_parameters=query_params,
)
async def fetch_emails(
message_builder: MailFolderMessagesRequestBuilder | UserMessagesRequestBuilder,
pagination_token: str | None = None,
request_config: MailFolderMessagesRequestBuilder.MessagesRequestBuilderGetRequestConfiguration
| None = None,
) -> MessageCollectionResponse:
"""Fetch emails from the user's mailbox.
Microsoft Graph Python SDK does not support pagination (as of 2025-04-17),
so we use raw URL for pagination if a pagination token is provided.
"""
if pagination_token:
return await message_builder.with_url(pagination_token).get() # type: ignore[return-value]
return await message_builder.get(request_configuration=request_config) # type: ignore[return-value, arg-type]
async def send_reply_email(
context: ToolContext,
message_id: str,
body: str,
reply_type: ReplyType,
) -> dict:
"""Send a reply email to the sender or all recipients of an existing email."""
client = get_client(context.get_auth_token_or_empty())
if reply_type == ReplyType.REPLY:
reply_request_body = ReplyPostRequestBody(comment=body)
await client.me.messages.by_message_id(message_id).reply.post(reply_request_body)
elif reply_type == ReplyType.REPLY_ALL:
reply_all_request_body = ReplyAllPostRequestBody(comment=body)
await client.me.messages.by_message_id(message_id).reply_all.post(reply_all_request_body)
return {
"success": True,
"message": "Email sent successfully",
}