# Microsoft 365 Copilot

```json
{
  "name": "Microsoft 365 Copilot",
  "slug": "microsoft_copilot",
  "url": "https://composio.dev/toolkits/microsoft_copilot",
  "markdown_url": "https://composio.dev/toolkits/microsoft_copilot.md",
  "logo_url": "https://logos.composio.dev/api/microsoft_copilot",
  "categories": [
    "ai & machine learning"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-11-17T05:40:12.341Z"
}
```

![Microsoft 365 Copilot logo](https://logos.composio.dev/api/microsoft_copilot)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Microsoft 365 Copilot MCP or direct API to search Microsoft Graph, retrieve Copilot conversations, analyze meeting insights, and review usage reports through natural language.

## Summary

Microsoft 365 Copilot is Microsoft's AI assistant for work across Microsoft 365 and Microsoft Graph.
It helps people find information, understand work activity, and get useful insights from their organization.

## Categories

- ai & machine learning

## Toolkit Details

- Tools: 74

## Images

- Logo: https://logos.composio.dev/api/microsoft_copilot

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Microsoft 365 Copilot.
  - Setup:
    - Configure Oauth2 credentials for Microsoft 365 Copilot.
    - Use the credentials when creating an auth config in Composio.
- **S2s Oauth2**
  - Type: `custom`
  - Description: S2s Oauth2 authentication for Microsoft 365 Copilot.
  - Setup:
    - Configure S2s Oauth2 credentials for Microsoft 365 Copilot.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Summarize recent Copilot interaction history
- Review Copilot usage reports by department
- Find insights from yesterday's Teams meetings

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `MICROSOFT_COPILOT_EXPORT_INTERACTIONS` | Export Interactions | DEFAULT FOR PRODUCTION: export a licensed user's Microsoft 365 Copilot prompts, responses, accessed resources, and interaction metadata through the stable v1.0 contract. Use Preview Export Interactions only to validate the separate beta endpoint or consume beta additions. Requires app-only S2S_OAUTH2 with admin-consented AiEnterpriseInteraction.Read.All; delegated OAuth unsupported. |
| `MICROSOFT_COPILOT_GET_COPILOT_PACKAGE` | Get Copilot Package | DEFAULT FOR PRODUCTION READS: get detailed information through the stable v1.0 contract for one provider-returned Copilot package ID. Use Preview Get Copilot Package when preparing a beta-only package mutation workflow. Requires Microsoft Agent 365, organization administrator access, and the Microsoft global cloud. |
| `MICROSOFT_COPILOT_GET_LIMITED_MODE` | Get Copilot Limited Mode | DEFAULT FOR PRODUCTION: get the tenant's Microsoft 365 Copilot limited-mode settings through the stable v1.0 contract. Use Preview Get Copilot Limited Mode only to validate beta behavior. Requires delegated work or school OAuth and at least the Global Reader role. Global cloud only; application permissions are unsupported. |
| `MICROSOFT_COPILOT_GET_MEETING_INSIGHT` | Get Meeting Insight | Get detailed notes, action items, and participant mention events for one meeting insight. Supports delegated work or school OAuth and app-only S2S OAuth with OnlineMeetingAiInsight.Read.All. App-only access also requires an application access policy granted to the user ID in the request path. The organizer must have a Microsoft 365 Copilot license, and the supported, non-expired meeting must have ended and been recorded or transcribed; insight processing can take up to four hours. |
| `MICROSOFT_COPILOT_GET_USAGE_USER_DETAIL_REPORT` | Get Usage User Detail Report | Download the stable v2 CSV containing the latest per-user usage for licensed Microsoft 365 Copilot users. Use this for user-level rows; use User Count Summary or Trend for aggregate adoption. WARNING: the file can contain sensitive user identifiers and activity data; do not log its contents. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role; this runtime role requirement does not apply to app-only calls. |
| `MICROSOFT_COPILOT_GET_USER_COUNT_SUMMARY_REPORT` | Get User Count Summary Report | Download the stable v2 CSV summary of enabled and active Microsoft 365 Copilot users by product. Use this for aggregate totals; use User Count Trend for day-by-day adoption and Usage User Detail for per-user rows. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Global Reader, Usage Summary Reports Reader, Reports Reader, or a supported service administrator; this runtime role requirement does not apply to app-only calls. |
| `MICROSOFT_COPILOT_GET_USER_COUNT_TREND_REPORT` | Get User Count Trend Report | Download the stable v2 CSV of daily enabled and active Microsoft 365 Copilot user trends. Use this for day-by-day adoption; use User Count Summary for aggregate totals and Usage User Detail for per-user rows. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Global Reader, Usage Summary Reports Reader, Reports Reader, or a supported service administrator; this runtime role requirement does not apply to app-only calls. |
| `MICROSOFT_COPILOT_LIST_COPILOT_PACKAGES` | List Copilot Packages | DEFAULT FOR PRODUCTION INVENTORY: return one server-managed page of Copilot packages through the stable v1.0 contract. Use Preview List Copilot Packages when preparing or verifying a workflow that uses beta-only package mutations. Requires Microsoft Agent 365, organization administrator access, and the Microsoft global cloud. Use only the documented filter combinations and pass next_cursor back unchanged to continue. |
| `MICROSOFT_COPILOT_LIST_MEETING_INSIGHTS` | List Meeting Insights | DEFAULT FOR PRODUCTION: list one page of AI insight records through the stable v1.0 contract for a completed, non-expired supported online meeting. Use the preview list only when continuing to Preview Get Meeting Insight for beta-only fields such as recap_url. Supports delegated work or school OAuth and app-only S2S OAuth with OnlineMeetingAiInsight.Read.All. App-only access also requires an application access policy granted to the user ID in the request path. The meeting organizer needs a Microsoft 365 Copilot license; usage-based payment and evaluation modes are unsupported. The meeting must be recorded or transcribed, insights appear only after it ends and can take up to four hours, channel meetings are unsupported, and the API is available only in the Microsoft global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_ADD_ASSIGNED_GROUP` | Preview Add Assigned Group | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Add an existing Entra group reference to a selected-groups spending policy. Requires the current parent policy ETag and sends an absolute beta Graph @odata.id. |
| `MICROSOFT_COPILOT_PREVIEW_ADD_EMAIL_THRESHOLD_RECIPIENT` | Preview Add Email Threshold Recipient | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Link a tenant user as an email threshold recipient through the documented @odata.id reference endpoint. The current provider-returned policy ETag is required. |
| `MICROSOFT_COPILOT_PREVIEW_BATCH_RECORD_CREDIT_REQUEST_DECISIONS` | Preview Batch Record Credit Request Decisions | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Approve or reject 1-100 credit requests independently. This operation is not atomic: HTTP 200 can contain per-item failures, and successful items are not rolled back. Requires the signed-in user to be a Global Administrator, Billing Administrator, or AI Administrator. Available only in the Microsoft Graph global service. Microsoft documents this operation, but it is absent from the current live beta metadata and generated beta OpenAPI; rollout availability is unverified. |
| `MICROSOFT_COPILOT_PREVIEW_BLOCK_COPILOT_PACKAGE` | Preview Block Copilot Package | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Block one Copilot package to prevent its use. Requires delegated work or school OAuth, Microsoft Agent 365, organization administrator access, and the global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_CHAT_IN_CONVERSATION` | Preview Chat in Conversation | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Append an irreversible user turn to an existing Copilot conversation and wait for one synchronous response. Use Preview Start Conversation when no conversation exists yet; use this action for subsequent turns. This requires a licensed work or school user. A failed HTTP response can still record the turn. |
| `MICROSOFT_COPILOT_PREVIEW_CREATE_AGENT_REGISTRATION` | Preview Create Agent Registration | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create a Microsoft 365 Copilot agent registration in the global cloud. Supply at least one owner_id or managed_by_app_id; a2a_reference_id also requires a2a_mode. |
| `MICROSOFT_COPILOT_PREVIEW_CREATE_CONVERSATION` | Preview Create Conversation | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create an empty Microsoft 365 Copilot conversation for later chat turns. Use Preview Start Conversation for the common create-and-send-first-turn workflow; use this action only when an empty conversation ID is independently needed. This requires a licensed work or school user and all seven delegated Chat permissions. Microsoft documents no delete operation for this surface, so the created conversation cannot be cleaned up through this toolkit. |
| `MICROSOFT_COPILOT_PREVIEW_CREATE_SERVICE_SETTING` | Preview Create Service Setting | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Add one governed service setting to a Copilot spending policy. The collection merges by serviceId, and the current provider-returned policy ETag is required. |
| `MICROSOFT_COPILOT_PREVIEW_CREATE_SPENDING_POLICY` | Preview Create Spending Policy | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create a disabled all-users or selected-groups Copilot Credit spending policy. Requires a Billing Administrator or Global Administrator; nonempty inline groups also require the assignment-write permission. |
| `MICROSOFT_COPILOT_PREVIEW_DELETE_AGENT_REGISTRATION` | Preview Delete Agent Registration | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Permanently delete a Microsoft 365 Copilot agent registration. This operation is irreversible and cannot be undone. |
| `MICROSOFT_COPILOT_PREVIEW_DELETE_EMAIL_THRESHOLD_SETTINGS` | Preview Delete Email Threshold Settings | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Delete a spending policy's email threshold configuration. This disables alerts but retains separately managed recipients. The provider-returned policy ETag is required. |
| `MICROSOFT_COPILOT_PREVIEW_DELETE_SPENDING_POLICY` | Preview Delete Spending Policy | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Delete a Copilot Credit spending policy and stop it governing consumption. Requires the current parent policy ETag. |
| `MICROSOFT_COPILOT_PREVIEW_EXPORT_INTERACTIONS` | Preview Export Interactions | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use only to validate the beta export contract or consume additive beta fields; for production exports use Export Interactions. Export a licensed user's Copilot interaction history. Requires the app-only S2S_OAUTH2 connection with admin-consented AiEnterpriseInteraction.Read.All; delegated OAuth is unsupported. |
| `MICROSOFT_COPILOT_PREVIEW_GET_AGENT_REGISTRATION` | Preview Get Agent Registration | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Retrieve one Microsoft 365 Copilot agent registration by ID in the global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_GET_COPILOT_PACKAGE` | Preview Get Copilot Package | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use when preparing or verifying beta-only package mutations; for production reads use Get Copilot Package. Get detailed information for one provider-returned Copilot package ID. Requires Microsoft Agent 365, organization administrator access, and the global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_GET_CREDIT_REQUEST` | Preview Get Credit Request | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one credit request and its quoted strong ETag for a later decision. Requires the signed-in user to be a Billing Administrator, Global Administrator, AI Administrator, Global Reader, or AI Reader. Available only in the Microsoft Graph global service. Microsoft documents this operation, but it is absent from the current live beta metadata and generated beta OpenAPI; rollout availability is unverified. |
| `MICROSOFT_COPILOT_PREVIEW_GET_EMAIL_THRESHOLD_SETTINGS` | Preview Get Email Threshold Settings | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get the notify-only email threshold configuration for one spending policy. Returns itemNotFound when no configuration exists and supports only $select. |
| `MICROSOFT_COPILOT_PREVIEW_GET_GROUP_USAGE_RECORD` | Preview Get Group Usage Record | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one group's Copilot Credit usage for exactly one completed UTC day. |
| `MICROSOFT_COPILOT_PREVIEW_GET_LIMITED_MODE` | Preview Get Copilot Limited Mode | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use only to validate the beta limited-mode read; for production use Get Copilot Limited Mode. Get the tenant's limited-mode settings. Requires delegated work or school OAuth and at least the Global Reader role. Global cloud only; application permissions are unsupported. |
| `MICROSOFT_COPILOT_PREVIEW_GET_MEETING_INSIGHT` | Preview Get Meeting Insight | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get detailed notes, action items, participant mention events, and the nullable beta recap URL for one eligible meeting insight. Supports delegated OAuth and app-only S2S OAuth with OnlineMeetingAiInsight.Read.All. App-only access also requires an application access policy granted to the user ID in the request path. The organizer needs a Microsoft 365 Copilot license. |
| `MICROSOFT_COPILOT_PREVIEW_GET_POLICY_SETTING` | Preview Get Copilot Policy Setting | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one tenant-level Microsoft 365 Copilot policy setting by its friendly identifier. Group-scoped settings are unsupported and return 422; global cloud only; application permissions are unsupported. |
| `MICROSOFT_COPILOT_PREVIEW_GET_SERVICE_SETTING` | Preview Get Service Setting | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one governed service setting from a Copilot spending policy. Supports only $select and requires delegated work or school OAuth. |
| `MICROSOFT_COPILOT_PREVIEW_GET_SERVICE_USAGE_RECORD` | Preview Get Service Usage Record | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one service's Copilot Credit usage for exactly one completed UTC day. |
| `MICROSOFT_COPILOT_PREVIEW_GET_SPENDING_POLICY` | Preview Get Spending Policy | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one polymorphic Copilot Credit spending policy. Child service, alert, recipient, and assigned-group relationships aren't expandable here. |
| `MICROSOFT_COPILOT_PREVIEW_GET_TENANT_CREDIT_BALANCE` | Preview Get Tenant Credit Balance | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get the tenant-wide Copilot Credit balance snapshot, one row per billing method. Values are credit quantities, not currency, prices, invoices, or forecasts. |
| `MICROSOFT_COPILOT_PREVIEW_GET_USAGE_USER_DETAIL_BY_DATE_REPORT` | Preview Get Usage User Detail by Date Report | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return sensitive per-user Microsoft 365 Copilot usage JSON for one report date. The date must fall from seven days before the latest reportRefreshDate through reportRefreshDate, inclusive; this window is not based on today's date. The action requests `$format=application/json` because Graph otherwise returns CSV even with an application/json Accept header. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Reports Reader, AI Administrator, or a supported service administrator; this runtime role requirement does not apply to app-only calls. Available only in the global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_GET_USAGE_USER_DETAIL_REPORT` | Preview Get Usage User Detail Report | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return the latest v2 per-user usage JSON for licensed Microsoft 365 Copilot users. Use Preview User Count Summary or Trend for aggregate adoption. The response can expose sensitive user identifiers. Requires delegated OAuth or app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Reports Reader or a supported service administrator; this runtime role requirement does not apply to app-only calls. |
| `MICROSOFT_COPILOT_PREVIEW_GET_USER_BALANCE` | Preview Get User Balance | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one user's computed Copilot consumption balance. The parent userBalances collection is not listable; use a provider user ID. Expanded service balances can be truncated; use the dedicated list action when all rows are required. |
| `MICROSOFT_COPILOT_PREVIEW_GET_USER_COUNT_SUMMARY_REPORT` | Preview Get User Count Summary Report | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return aggregate enabled and active totals by product as v2 JSON. Use Preview User Count Trend for day-by-day adoption or Preview Usage User Detail for per-user rows. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Global Reader, Usage Summary Reports Reader, Reports Reader, or a supported service administrator; this runtime role requirement does not apply to app-only calls. |
| `MICROSOFT_COPILOT_PREVIEW_GET_USER_COUNT_TREND_REPORT` | Preview Get User Count Trend Report | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return the JSON daily trend of enabled and active Microsoft 365 Copilot users. Use Preview User Count Summary for aggregate totals or Preview Usage User Detail for per-user rows. Supports delegated OAuth and app-only S2S OAuth with Reports.Read.All. Delegated callers additionally need a signed-in user holding an accepted Microsoft Entra limited administrator role, such as Global Reader, Usage Summary Reports Reader, Reports Reader, or a supported service administrator; this runtime role requirement does not apply to app-only calls. |
| `MICROSOFT_COPILOT_PREVIEW_GET_USER_SERVICE_BALANCE` | Preview Get User Service Balance | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one service balance row for one user. |
| `MICROSOFT_COPILOT_PREVIEW_GET_USER_USAGE_DETAIL` | Preview Get User Usage Detail | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one user's raw usage detail for a UTC window of at most 24 hours. Expanded sessions are only the first nested page. |
| `MICROSOFT_COPILOT_PREVIEW_GET_USER_USAGE_RECORD` | Preview Get User Usage Record | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Get one user's Copilot Credit usage for exactly one completed UTC day. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_ASSIGNED_GROUPS` | Preview List Assigned Groups | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List group objects assigned to a selected-groups spending policy through the required selectedGroupsSpendingPolicy cast path. Tenant-wide policies return 404. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_COPILOT_PACKAGES` | Preview List Copilot Packages | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use when preparing or verifying beta-only package update, block, unblock, or reassign workflows; for production read-only inventory use List Copilot Packages. Return one server-managed page of packages available in the tenant. Requires Microsoft Agent 365, organization administrator access, and the Microsoft global cloud. Pass next_cursor back unchanged to continue. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_CREDIT_REQUESTS` | Preview List Credit Requests | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List tenant credit requests in Microsoft's fixed newest-first order. Requires the signed-in user to be a Billing Administrator, Global Administrator, AI Administrator, Global Reader, or AI Reader. Available only in the Microsoft Graph global service. Microsoft documents this operation, but it is absent from the current live beta metadata and generated beta OpenAPI; rollout availability is unverified. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_EMAIL_THRESHOLD_RECIPIENTS` | Preview List Email Threshold Recipients | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List user objects configured to receive one spending policy's threshold emails. This operation supports no OData query parameters. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_FUNDING_USAGE_RECORDS` | Preview List Funding Usage Records | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List Copilot Credit consumption by funding class for one YYYY-MM month. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_GROUP_USAGE_RECORDS` | Preview List Group Usage Records | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Rank per-group Copilot Credit usage for exactly one completed UTC day. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_MEETING_INSIGHTS` | Preview List Meeting Insights | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use when the returned insight ID will be passed to Preview Get Meeting Insight for beta-only fields such as recap_url; otherwise use List Meeting Insights. List AI insight records for one completed, non-expired supported meeting. Supports delegated OAuth and app-only S2S OAuth with OnlineMeetingAiInsight.Read.All. App-only access also requires an application access policy granted to the user ID in the request path. The organizer needs a Microsoft 365 Copilot license; recording or transcription is required, insights are available only after the meeting ends and can take up to four hours, and pay-as-you-go and evaluation modes are unsupported. Private scheduled meetings, town halls, webinars, and Meet Now are supported; channel meetings are not. Available only in the global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_SERVICE_SETTINGS` | Preview List Service Settings | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List every service setting attached to one Copilot spending policy. Supports only $select and requires delegated work or school OAuth. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_SERVICE_USAGE_RECORDS` | Preview List Service Usage Records | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Rank per-service Copilot Credit usage for exactly one completed UTC day. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_SPENDING_POLICIES` | Preview List Spending Policies | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return one page of polymorphic Copilot Credit spending policies. Supports only the documented policy-list OData projection, paging, filter, count, and ordering options. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_USER_SERVICE_BALANCES` | Preview List User Service Balances | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List one user's per-service Copilot balances using only Microsoft's supported serviceId and consumption-decision query profile. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_USER_USAGE_RECORDS` | Preview List User Usage Records | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Rank per-user Copilot Credit usage for exactly one completed UTC day. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_USER_USAGE_SERVICE_DETAILS` | Preview List User Usage Service Details | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. List one user's per-service raw usage for a UTC window of at most 24 hours. |
| `MICROSOFT_COPILOT_PREVIEW_LIST_USER_USAGE_SESSION_DETAILS` | Preview List User Usage Session Details | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Return one page of one user's raw session usage for a UTC window of at most 24 hours. |
| `MICROSOFT_COPILOT_PREVIEW_REASSIGN_COPILOT_PACKAGE` | Preview Reassign Copilot Package | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Reassign one Copilot package to a new owner by Microsoft Entra user ID. Requires delegated work or school OAuth, Microsoft Agent 365, organization administrator access, and the global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_REMOVE_ASSIGNED_GROUP` | Preview Remove Assigned Group | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Remove an Entra group reference through the selectedGroupsSpendingPolicy cast path. Requires the current parent policy ETag and refuses removal of the last group. |
| `MICROSOFT_COPILOT_PREVIEW_REMOVE_EMAIL_THRESHOLD_RECIPIENT` | Preview Remove Email Threshold Recipient | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Unlink one user from a spending policy's email threshold recipients. Microsoft refuses removal of the last recipient while alerting is enabled. The parent policy provider-returned policy ETag is required. |
| `MICROSOFT_COPILOT_PREVIEW_RETRIEVE_CONTENT` | Preview Retrieve Content | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Retrieve grounding extracts with beta-only page numbers and optional thumbnails; the same Copilot licensing or eligible pay-as-you-go prerequisites apply. |
| `MICROSOFT_COPILOT_PREVIEW_SEARCH` | Preview Search Copilot Content | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Search OneDrive for work or school content for a licensed Microsoft 365 Copilot user. Official beta metadata marks this operation deprecated with a 2025-09-15 removal date, while Microsoft Learn still documents it; treat availability as unverified and do not rely on it for production. Global cloud only; limited to 200 requests per user per hour. |
| `MICROSOFT_COPILOT_PREVIEW_START_CONVERSATION` | Preview Start Conversation | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create a Copilot conversation and send its first synchronous user turn in one tool call. Both effects are irreversible: Microsoft exposes no conversation delete API, and a failed chat can still leave the empty conversation or record the turn. Use Preview Chat in Conversation for later turns. |
| `MICROSOFT_COPILOT_PREVIEW_STREAM_CHAT_IN_CONVERSATION` | Preview Stream Chat in Conversation | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Append an irreversible turn and collect server-sent Copilot conversation updates plus raw SSE diagnostics until the response closes. Use synchronous Chat in Conversation when only the final answer is needed. Requires a licensed work or school user; a 200 stream can contain a license-denial conversation, surfaced as semantic_status=possible_license_denial without retrying the turn. |
| `MICROSOFT_COPILOT_PREVIEW_UNBLOCK_COPILOT_PACKAGE` | Preview Unblock Copilot Package | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Unblock one Copilot package to allow its use. Requires delegated work or school OAuth, Microsoft Agent 365, organization administrator access, and the global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_UPDATE_AGENT_REGISTRATION` | Preview Update Agent Registration | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Update at least one property of a Microsoft 365 Copilot agent registration. Omitted fields are retained, explicit null clears nullable fields, and a2a_reference_id requires a2a_mode. |
| `MICROSOFT_COPILOT_PREVIEW_UPDATE_COPILOT_PACKAGE` | Preview Update Copilot Package | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Update a package's availability or deployment assignments. Microsoft Learn's operation page controls the request contract: it documents allowedFor* and acquiredFor* wire values, which conflict with current Graph metadata's none/some/all values. This action intentionally exposes only the Learn values. Supply at least one update field; assignment lists require their matching available_to or deployed_to status. Requires delegated work or school OAuth, Microsoft Agent 365, organization administrator access, and the global cloud. |
| `MICROSOFT_COPILOT_PREVIEW_UPDATE_CREDIT_REQUEST` | Preview Update Credit Request | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Approve or reject one pending credit request using its latest quoted strong ETag. The decision can change state even if a later response is lost. Requires the signed-in user to be a Global Administrator, Billing Administrator, or AI Administrator. Available only in the Microsoft Graph global service. Microsoft documents this operation, but it is absent from the current live beta metadata and generated beta OpenAPI; rollout availability is unverified. |
| `MICROSOFT_COPILOT_PREVIEW_UPDATE_EMAIL_THRESHOLD_SETTINGS` | Preview Update Email Threshold Settings | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Create or merge-update notify-only email thresholds for one spending policy. Omitted fields retain state, null is rejected, [] clears thresholds, and recipients must be managed separately. An empty update intentionally creates default settings when absent and is a no-op when they already exist. The current provider-returned policy ETag is required. |
| `MICROSOFT_COPILOT_PREVIEW_UPDATE_LIMITED_MODE` | Preview Update Copilot Limited Mode | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Use only to validate the beta limited-mode mutation; for production use Update Copilot Limited Mode. Update the tenant's limited-mode settings. Requires delegated work or school OAuth and the Global Administrator role. Global cloud only; application permissions are unsupported. Supply at least one field; group_id is required when enabling the setting. |
| `MICROSOFT_COPILOT_PREVIEW_UPDATE_POLICY_SETTING` | Preview Update Copilot Policy Setting | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Update one tenant-level Microsoft 365 Copilot policy setting by its friendly identifier. Group-scoped settings are unsupported and return 422; global cloud only; application permissions are unsupported. |
| `MICROSOFT_COPILOT_PREVIEW_UPDATE_SERVICE_SETTING` | Preview Update Service Setting | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Change one service setting's state. Setting state to disabled is the documented removal semantic; the current provider-returned policy ETag is required. |
| `MICROSOFT_COPILOT_PREVIEW_UPDATE_SPENDING_POLICY` | Preview Update Spending Policy | PREVIEW/BETA: Microsoft does not support beta Graph APIs for production. Update only a policy's display name, monthly limits, or billing-method flags. Supply at least one of those fields. Requires the current parent policy ETag and never writes lifecycle or audit fields. |
| `MICROSOFT_COPILOT_RETRIEVE_CONTENT` | Retrieve Content | Retrieve unordered grounding extracts from one SharePoint, OneDrive for Business, or Copilot connector source. Requires delegated work or school OAuth and a Microsoft 365 Copilot license or eligible pay-as-you-go retrieval configuration. |
| `MICROSOFT_COPILOT_UPDATE_LIMITED_MODE` | Update Copilot Limited Mode | DEFAULT FOR PRODUCTION: update the tenant's Microsoft 365 Copilot limited-mode settings through the stable v1.0 contract. Use Preview Update Copilot Limited Mode only for beta contract validation. Requires delegated work or school OAuth and the Global Administrator role. Global cloud only; application permissions are unsupported. Supply at least one field; group_id is required when enabling the setting. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to Microsoft 365 Copilot
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["microsoft_copilot"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["microsoft_copilot"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run Microsoft 365 Copilot tools with your agent

Send a request, execute the Microsoft 365 Copilot tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "Find my Microsoft 365 Copilot interaction history from yesterday and summarize the top three topics."}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Find my Microsoft 365 Copilot interaction history from yesterday and summarize the top three topics." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to Microsoft 365 Copilot and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["microsoft_copilot"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["microsoft_copilot"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a Microsoft 365 Copilot request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to Microsoft 365 Copilot tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("Find my Microsoft 365 Copilot interaction history from yesterday and summarize the top three topics.")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Find my Microsoft 365 Copilot interaction history from yesterday and summarize the top three topics.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native Microsoft 365 Copilot Integration

- Supports both Microsoft 365 Copilot MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for Copilot retrieval, search, conversations, meeting insights, reports, and administration

### 2. Managed Auth

- Connect Microsoft 365 Copilot with OAuth 2.0 or service-to-service OAuth 2.0 credentials
- Central place to manage, scope, and revoke Microsoft 365 Copilot access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Microsoft 365 Copilot
- Scoped, least privilege access to Microsoft 365 Copilot resources
- Full audit trail of agent actions to support review and compliance

## Use Microsoft 365 Copilot with any AI Agent Framework

Choose a framework you want to connect Microsoft 365 Copilot with:

- [ChatGPT](https://composio.dev/toolkits/microsoft_copilot/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/microsoft_copilot/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/microsoft_copilot/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/microsoft_copilot/framework/atomic-agent)

## Related Toolkits

- [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed.
- [Composio search](https://composio.dev/toolkits/composio_search) - Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service.
- [Perplexityai](https://composio.dev/toolkits/perplexityai) - Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows.
- [Browser tool](https://composio.dev/toolkits/browser_tool) - Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow.
- [Ai ml api](https://composio.dev/toolkits/ai_ml_api) - Ai ml api is a suite of AI/ML models for natural language and image tasks. It provides fast, scalable access to advanced AI capabilities for your apps and workflows.
- [Aivoov](https://composio.dev/toolkits/aivoov) - Aivoov is an AI-powered text-to-speech platform offering 1,000+ voices in over 150 languages. Instantly turn written content into natural, human-like audio for any application.
- [All images ai](https://composio.dev/toolkits/all_images_ai) - All-Images.ai is an AI-powered image generation and management platform. It helps you create, search, and organize images effortlessly with advanced AI capabilities.
- [AllModels](https://composio.dev/toolkits/allmodels) - AllModels is a unified API for text-to-speech, speech-to-text, realtime voice, and voice cloning across AI providers. It gives developers one consistent way to build and manage voice features.
- [AltTextLab](https://composio.dev/toolkits/alt_text_lab) - AltTextLab is an AI service that generates accessible, SEO-aware alt text for images. It helps teams make image content easier to understand, index, and publish.
- [Anthropic administrator](https://composio.dev/toolkits/anthropic_administrator) - Anthropic administrator is an API for managing Anthropic organizational resources like members, workspaces, and API keys. It helps you automate admin tasks and streamline resource management across your Anthropic organization.
- [Api labz](https://composio.dev/toolkits/api_labz) - Api labz is a platform offering a suite of AI-driven APIs and workflow tools. It helps developers automate tasks and build smarter, more efficient applications.
- [Apiframe](https://composio.dev/toolkits/apiframe) - Apiframe is an API platform for generating and managing AI images, videos, music, uploads, assets, jobs, and custom LoRAs. It gives developers one clean API for creative AI workflows without juggling multiple model providers.
- [Apipie ai](https://composio.dev/toolkits/apipie_ai) - Apipie ai is an AI model aggregator offering a single API for accessing top AI models from multiple providers. It helps developers build cost-efficient, latency-optimized AI solutions without juggling multiple integrations.
- [Arize AX](https://composio.dev/toolkits/arize_ax) - Arize AX is an AI engineering platform for tracing, evaluating, and improving AI applications. Use it to debug LLM behavior, compare experiments, and improve production AI quality.
- [Artificial Analysis](https://composio.dev/toolkits/artificial_analysis) - Artificial Analysis is an independent benchmarking platform for AI models and API providers. Use it to compare model intelligence, coding, math, pricing, latency, throughput, and arena rankings.
- [AssemblyAI](https://composio.dev/toolkits/assemblyai) - AssemblyAI is a speech-to-text and audio intelligence API for uploaded or hosted media. Use it to turn audio and video into accurate transcripts, summaries, and insights.
- [Astica ai](https://composio.dev/toolkits/astica_ai) - Astica ai provides APIs for computer vision, NLP, and voice synthesis. Integrate advanced AI features into your app with a single API key.
- [Avoma](https://composio.dev/toolkits/avoma) - Avoma is an AI meeting assistant for recording, transcribing, analyzing, and managing meetings, calls, notes, scorecards, and conversation intelligence. It helps teams turn conversations into searchable notes, follow-ups, coaching insights, and revenue intelligence.
- [Bigml](https://composio.dev/toolkits/bigml) - BigML is a machine learning platform that lets you build, train, and deploy predictive models from your data. Its intuitive interface and robust API make machine learning accessible and efficient.
- [Black Forest Labs](https://composio.dev/toolkits/bfl) - Black Forest Labs provides hosted FLUX models for generating and editing images and videos. It offers fast, flexible media creation with asynchronous processing and fine-tuning support.

## Frequently Asked Questions

### Do I need my own developer credentials to use Microsoft 365 Copilot with Composio?

Yes, Microsoft 365 Copilot requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
