How to integrate Microsoft 365 Copilot MCP with Hermes

Connect Hermes to Microsoft 365 Copilot MCP. Summarize recent copilot interaction history, review copilot usage reports by department, and more using natural language, with authentication handled for you.

Microsoft 365 Copilot logoMicrosoft 365 Copilot
Oauth2S2s Oauth2

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.

74 Tools

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.

Also integrate Microsoft 365 Copilot with

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.

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
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Microsoft 365 Copilot

Ask your agent to connect to Microsoft 365 Copilot, or simply request any Microsoft 365 Copilot-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Microsoft 365 Copilot connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Microsoft 365 Copilot or request any Microsoft 365 Copilot-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

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 or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Microsoft 365 Copilot action and event your agent gets out of the box.

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.

Get Copilot Package

DEFAULT FOR PRODUCTION READS: get detailed information through the stable v1.0 contract for one provider-returned Copilot package ID.

Get Copilot Limited Mode

DEFAULT FOR PRODUCTION: get the tenant's Microsoft 365 Copilot limited-mode settings through the stable v1.0 contract.

Get Meeting Insight

Get detailed notes, action items, and participant mention events for one meeting insight.

Get Usage User Detail Report

Download the stable v2 CSV containing the latest per-user usage for licensed Microsoft 365 Copilot users.

Get User Count Summary Report

Download the stable v2 CSV summary of enabled and active Microsoft 365 Copilot users by product.

Get User Count Trend Report

Download the stable v2 CSV of daily enabled and active Microsoft 365 Copilot user trends.

List Copilot Packages

DEFAULT FOR PRODUCTION INVENTORY: return one server-managed page of Copilot packages through the stable v1.0 contract.

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.

Preview Add Assigned Group

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Add Email Threshold Recipient

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Batch Record Credit Request Decisions

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Block Copilot Package

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Chat in Conversation

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Create Agent Registration

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Create Conversation

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Create Service Setting

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Create Spending Policy

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Delete Agent Registration

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Delete Email Threshold Settings

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Delete Spending Policy

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Export Interactions

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Agent Registration

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Copilot Package

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Credit Request

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Email Threshold Settings

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Group Usage Record

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Copilot Limited Mode

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Meeting Insight

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Copilot Policy Setting

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Service Setting

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Service Usage Record

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Spending Policy

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Tenant Credit Balance

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Usage User Detail by Date Report

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get Usage User Detail Report

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get User Balance

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get User Count Summary Report

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get User Count Trend Report

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get User Service Balance

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get User Usage Detail

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Get User Usage Record

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Assigned Groups

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Copilot Packages

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Credit Requests

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Email Threshold Recipients

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Funding Usage Records

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Group Usage Records

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Meeting Insights

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Service Settings

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Service Usage Records

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List Spending Policies

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List User Service Balances

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List User Usage Records

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List User Usage Service Details

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview List User Usage Session Details

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Reassign Copilot Package

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Remove Assigned Group

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Remove Email Threshold Recipient

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Retrieve Content

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Search Copilot Content

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Start Conversation

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Stream Chat in Conversation

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Unblock Copilot Package

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Update Agent Registration

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Update Copilot Package

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Update Credit Request

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Update Email Threshold Settings

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Update Copilot Limited Mode

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Update Copilot Policy Setting

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Update Service Setting

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Preview Update Spending Policy

PREVIEW/BETA: Microsoft does not support beta Graph APIs for production.

Retrieve Content

Retrieve unordered grounding extracts from one SharePoint, OneDrive for Business, or Copilot connector source.

Update Copilot Limited Mode

DEFAULT FOR PRODUCTION: update the tenant's Microsoft 365 Copilot limited-mode settings through the stable v1.0 contract.

FAQ

Frequently asked questions

Start with Microsoft 365 Copilot.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Microsoft 365 Copilot tool your agent needs.Free to start.

Start building