Last updated: 4 July 2026
Outlook
LiveSearch emails, read calendars, send messages, and schedule events through Microsoft Outlook.
Who needs this: Any team using Microsoft 365 that wants to query email history or manage calendar events through AI.
Example questions once connected
- Summarise emails from the finance team about the Q2 budget
- Do I have any meetings tomorrow afternoon?
- Send a follow-up email to [email protected]
- Schedule a call with the KRA team for next Tuesday at 10 AM
What you need before starting
- A Microsoft 365 account (Business or Enterprise)
- Permission to grant app consent — or ask your IT admin
⚠️
Delegated permissions only. Msharti uses delegated permissions — the AI can only do what you can do. It cannot access other people's emails or change your password. Token refresh is fully automatic.
Step-by-step setup
- Generate a Connect Link. In your Msharti dashboard, go to Connectors → Outlook → Connect. Msharti creates a unique link. Click Open in Browser.
- Log in with Microsoft. Sign in with your Microsoft 365 account. Microsoft shows a consent screen listing what Msharti can access. Review and click Accept.
- Confirm in dashboard. Microsoft redirects you back to Msharti. The connector now shows Connected. Tokens are stored securely — you never need to reconnect unless your password changes or an IT admin revokes access.
Tool reference
These are the tools the AI can call on this connector. Each tool fires automatically when you ask a relevant question.
search_mail() Search emails by keyword, sender, recipient, subject, or date range. Inputs query string, optional: folder, sender, date_from, date_to
Try asking "Find all emails from [email protected] about the audit in the last 30 days"
Returns 4 emails found. Latest: "Re: Q1 Audit Schedule" (3 Jun 2026). Attachments: 2 PDFs.
send_mail() Send an email from the connected Outlook account. Inputs to, subject, body, optional: cc, attachments
Try asking "Send a payment confirmation to [email protected]"
Returns Email sent to [email protected]. Subject: "Payment Confirmation — Invoice INV-2026-0441". Delivered.
list_calendar() List upcoming calendar events in a given time window. Inputs optional: start_date, end_date, calendar_name
Try asking "What meetings do I have this week?"
Returns Mon 9 Jun: Board review (9:00 AM). Tue 10 Jun: Supplier call (2:00 PM). Thu 12 Jun: Team standup (8:30 AM).
schedule_event() Create a calendar event and optionally send invites to attendees. Inputs title, start_datetime, end_datetime, optional: attendees, location, body
Try asking "Book a 30-minute call with the KRA team next Tuesday at 10 AM"
Returns Event created: "KRA Team Call" on Tue 17 Jun 2026, 10:00–10:30 AM. Invite sent to [email protected].
Limits
- Uses delegated Microsoft permissions — the AI can only access what the signed-in user can access.
- Token auto-refresh every 60 minutes. The dashboard flags tokens expiring within 7 days.
- Sending email is gated to Business and Enterprise plans.
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| Admin consent required | IT admin has restricted third-party app access | Ask your IT admin to approve "Msharti MCP Platform" in the Azure AD admin centre. |
| Token expired | Refresh token expired | Click Reconnect in dashboard. |
| Insufficient permissions | Consent screen not fully accepted | Disconnect and reconnect, accepting all permissions. |
Need help? [email protected] — Nairobi-based, same time zone.