Outlook (Microsoft Graph)
Read and write Outlook email, calendar events, and Microsoft To-Do tasks using the Microsoft Graph API. Requires the user to connect their Microsoft 365 account from Settings → Integrations (one-time OAuth consent).
Capabilities
Dispatched via a single outlook tool that takes an action parameter. See the
tool description for the full action list.
Email (13 actions)
email_inbox- First N messages in Inbox (default 10)email_read- Full message bymessageId, or thread byconversationIdemail_send- Compose + send (HTML body, CC/BCC, attachments)email_reply- Reply (or reply-all) to an existing messageemail_forward- Forward with optional comment + attachmentsemail_search- KQL search across mailbox or specific folderemail_folders- List mail folders or list messages in a folderemail_draft- CRUD drafts (operation: list/read/create/update/delete)email_attachments- List or download attachments on a messageemail_contacts- List/search Outlook contactsemail_move- Move a message to another folderemail_categories- List the mailbox's master category listemail_update- Flag for follow-up, set categories, importance, read state
Calendar (6 actions)
calendar_view- Events in a date range (default: today)calendar_meeting- CRUD + RSVP (operation: create/read/update/delete/rsvp)calendar_availability- getSchedule for one or more userscalendar_room_booking- List rooms / buildings / rooms-in-buildingcalendar_search- Search events by title/body keywordcalendar_shared_list- Calendars the user has access to
To-Do (3 actions)
todo_lists- Manage task lists (list/create/update/delete)todo_tasks- Manage tasks within a list (list/get/create/update/delete/complete)todo_checklist- Manage subtasks within a task (list/create/update/delete/toggle)
When to use
- User asks about email (inbox, unread, search, send, reply, forward)
- User asks about calendar / schedule / meetings / availability / agenda
- User asks about Microsoft To-Do tasks or checklists
- User mentions "Outlook", "Office 365", or "M365"
Setup
- Open Settings → Integrations in Foxl
- Click "Connect Microsoft 365"
- Sign in with your work/school or personal Microsoft account
- Accept the permission scopes (Mail, Calendar, Tasks, Profile)
- Return to Foxl - the tool is now available
Notes
- HTML email bodies are supported; plain text auto-detected based on leading
< - Times default to the system timezone; pass
timeZoneto override - Attachments use base64-encoded inline upload (works for files up to ~3MB); larger files require the upload session flow (not yet implemented)
- Rate limits: Graph enforces per-app and per-user throttling; the tool surfaces 429 errors verbatim