# How to integrate Microsoft 365 Copilot MCP with Hermes

```json
{
  "title": "How to integrate Microsoft 365 Copilot MCP with Hermes",
  "toolkit": "Microsoft 365 Copilot",
  "toolkit_slug": "microsoft_copilot",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/microsoft_copilot/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/microsoft_copilot/framework/hermes-agent.md",
  "updated_at": "2026-11-17T05:40:12.341Z"
}
```

## Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.
This guide explains the easiest and most robust way to connect your Microsoft 365 Copilot account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.
For exact tool slugs and parameter tables, see the [tool catalog in the Composio docs](https://docs.composio.dev/toolkits/microsoft_copilot).

## Also integrate Microsoft 365 Copilot with

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

## TL;DR

### What is Composio Connect?
Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:
- Search and load tools from relevant toolkits on-demand, reducing context usage.
- Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
- Manage app authentication end-to-end with zero manual overhead.

## Connect Microsoft 365 Copilot to Hermes

### Integrating Microsoft 365 Copilot with Hermes
### Using Composio Connect CLI
1. Install the Composio CLI
Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

```bash
curl -fsSL https://composio.dev/install | bash
```

## What is the Microsoft 365 Copilot MCP server, and what's possible with it?

The Microsoft 365 Copilot MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Microsoft 365 Copilot account. It provides structured and secure access to Copilot conversations, meeting insights, usage reports, interaction history, packages, tenant settings, and credit management, so your agent can review activity, analyze usage, inspect meetings, manage Copilot resources, and track credit information on your behalf.
- Copilot interaction history: Have your agent export a licensed user's Copilot prompts, responses, accessed resources, and interaction details.
- Meeting insights: Let the agent list available meeting insights and retrieve notes, action items, and participant mention events from supported completed meetings.
- Usage reporting: Direct your agent to download user detail, user count summary, and daily user trend reports for Microsoft 365 Copilot.
- Copilot package and tenant management: Instruct your agent to list and inspect Copilot packages, check limited-mode settings, and work with available tenant administration settings.
- Credit and spending oversight: Have your agent review Copilot credit balances, user balances, service balances, spending policies, and related credit requests.

## 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.

## Creating MCP Server - Stand-alone vs Composio SDK

The Microsoft 365 Copilot MCP server provides comprehensive access to Microsoft 365 Copilot operations through Composio. Once connected, Hermes can perform all major Microsoft 365 Copilot actions on your behalf using natural language commands.

## Complete Code

None listed.

## Conclusion

### Way Forward
With Microsoft 365 Copilot connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.
From here, you can extend Hermes further:
- Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
- Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
- Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.
If you run into trouble or want to share what you've built, join the [community](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?cta_placement=toolkit-framework-hermes-docs) for deeper configuration options.

## How to build Microsoft 365 Copilot MCP Agent with another framework

- [ChatGPT](https://composio.dev/toolkits/microsoft_copilot/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/microsoft_copilot/framework/claude-cowork)
- [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

### What are the differences in Tool Router MCP and Microsoft 365 Copilot MCP?

With a standalone Microsoft 365 Copilot MCP server, the agents and LLMs can only access a fixed set of Microsoft 365 Copilot tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Microsoft 365 Copilot and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Hermes?

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Microsoft 365 Copilot tools.

### Can I manage the permissions and scopes for Microsoft 365 Copilot while using Tool Router?

Yes, absolutely. You can configure which Microsoft 365 Copilot scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Microsoft 365 Copilot data and credentials are handled as safely as possible.

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