Skip to main content

Microsoft Outlook

Connect SVAHNAR to your Microsoft account to give agents access to Outlook mail and calendar via the Microsoft Graph API.


What Agents Can Do

OperationDescription
important_mailRetrieve high-priority flagged messages
mail_from_addressFind emails from a specific sender
content_search_in_mailSearch mailbox content by keyword
send_mailSend an email on your behalf
event_for_weekRetrieve calendar events for a date range
all_eventList all calendar events
all_calendarList all calendars in your account
schedule_meetCreate a calendar meeting or event

Connecting Microsoft Outlook

Open Connections

Go to the Connections page in the SVAHNAR Platform.

Connect Outlook

Click Connect on the Microsoft Outlook provider card.

A Microsoft sign-in popup will open.

Sign in and Approve

Log in to your Microsoft account (personal, work, or school) and approve the requested permissions.

Work & School Accounts

If your organization requires admin consent for third-party apps, you may see a message that administrator approval is required. Contact your Microsoft 365 admin to grant consent for SVAHNAR in your organization's Azure Active Directory.

Confirm Connection

The popup closes. The Microsoft Outlook card updates to Connected.


Using Outlook in an Agent

agent.yaml
create_agent_network:
agent-1:
agent_name: "Outlook_Assistant"
LLM_config:
params:
model: "gpt-5"
tools:
tool_assigned:
- name: Outlook
agent_function:
- "Help the user check their important emails and schedule meetings."
incoming_edge:
- Start
outgoing_edge: []

For detailed tool configuration, see the Outlook Tool reference.


Permissions Requested

PermissionPurpose
Mail.ReadRead emails in your mailbox
Mail.SendSend emails on your behalf
Calendars.ReadWriteRead and create calendar events
User.ReadRead your basic profile information
offline_accessMaintain access via refresh tokens

Disconnect

Click Disconnect on the Microsoft Outlook card. SVAHNAR deletes the stored token immediately. Microsoft tokens expire naturally — there is no active revocation step on Microsoft's end.