This is a catch-all provider — any valid URL under
https://graph.microsoft.com/v1.0 is supported. Any Microsoft Graph v1.0 endpoint. Construct URL as https://graph.microsoft.com/v1.0/{path}. See https://learn.microsoft.com/en-us/graph/api/overview for full reference. The endpoints below are curated examples.Connecting Your Microsoft 365 Account
Lava supports two ways to connect a Microsoft 365 account. Both end in the same place — Lava stores an encrypted OAuth token scoped to your wallet and uses it only to forward your own API calls. Via MCP (automatic):- An agent connected to Lava’s MCP calls a Microsoft 365 endpoint for the first time.
- Lava detects no stored credential and returns a
browser_flow_requiredresponse containing an authorization URL. - Open the URL in a browser — you land on Microsoft 365’s consent screen.
- Review the requested scopes (listed below) and click Allow.
- Microsoft 365 redirects back to Lava. Your token is stored and the original agent call can now proceed.
- Sign in at lava.so/dashboard and open Connected Services (
/dashboard/wallet/connected-services). - Find Microsoft 365 in the list of available providers and click Connect.
- Authorize in Microsoft 365’s consent screen.
- You’re redirected back to the Connected Services page, where Microsoft 365 now appears under Stored Credentials.
Requested Permissions
Lava requests only the scopes needed to route your API calls. You see this list on Microsoft 365’s consent screen before you authorize.| Scope | What It Enables |
|---|---|
offline_access | Refresh tokens |
User.Read | Read user profile |
Mail.ReadWrite | Read and manage email |
Mail.Send | Send email |
Calendars.ReadWrite | Read and manage calendar |
Files.ReadWrite | Read and manage OneDrive files |
Team.ReadBasic.All | List joined Teams |
ChannelMessage.Read.All | Read Teams channel messages |
Using Microsoft 365
Once connected, your credential is available to any agent or SDK call routed through Lava’s gateway — no token passing required. Call Microsoft 365 endpoints throughhttps://api.lava.so/v1/forward and Lava injects your stored token automatically. See the Endpoints section below for example calls.
Removing Microsoft 365
Disconnecting removes Lava’s stored token immediately. Subsequent API calls return an auth error until you reconnect. Via dashboard:- Open Connected Services.
- Find Microsoft 365 under Stored Credentials.
- Click the trash icon and confirm.
- REST:
DELETE https://api.lava.so/v1/credentials/microsoft_o365(returns 204 No Content). - MCP: call the
disconnect_servicetool withservice: "microsoft_o365".
Data Handling
Lava stores your Microsoft 365 OAuth access and refresh tokens encrypted at rest, scoped to your wallet. Tokens are used only to forward your own API calls to https://graph.microsoft.com/v1.0. Refresh tokens rotate automatically; if a refresh fails, your next call prompts you to reconnect. Lava does not read, cache, or redistribute Microsoft 365 content beyond what’s needed to proxy a single request.Support
Questions about this integration: support@lava.so.Endpoints
Get the signed-in user profile
GEThttps://graph.microsoft.com/v1.0/me — Free
- SDK
- cURL
List inbox messages
GEThttps://graph.microsoft.com/v1.0/me/messages?$top=10&$orderby=receivedDateTime%20desc — Free
- SDK
- cURL
Send an email
POSThttps://graph.microsoft.com/v1.0/me/sendMail — Free
- SDK
- cURL
List calendar events
GEThttps://graph.microsoft.com/v1.0/me/events?$top=10&$orderby=start/dateTime — Free
- SDK
- cURL
Create a calendar event
POSThttps://graph.microsoft.com/v1.0/me/events — Free
- SDK
- cURL
List files in OneDrive root
GEThttps://graph.microsoft.com/v1.0/me/drive/root/children — Free
- SDK
- cURL
List joined Teams
GEThttps://graph.microsoft.com/v1.0/me/joinedTeams — Free
- SDK
- cURL
Update a calendar event
PATCHhttps://graph.microsoft.com/v1.0/me/events/{event-id} — Free
- SDK
- cURL
Upload or replace a file in OneDrive
PUThttps://graph.microsoft.com/v1.0/me/drive/root:/{filename}:/content — Free
- SDK
- cURL
Delete a calendar event
DELETEhttps://graph.microsoft.com/v1.0/me/events/{event-id} — Free
- SDK
- cURL
Next Steps
All Providers
Browse all supported AI providers
Forward Proxy
Learn how to construct proxy URLs and authenticate requests