How to integrate Microsoft 365 Copilot MCP with Atomic Agent

Connect Atomic Agent 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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Microsoft 365 Copilot.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Microsoft 365 Copilot account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Microsoft 365 Copilot with

How Atomic Agent connects to Microsoft 365 Copilot

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Microsoft 365 Copilot to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Microsoft 365 Copilot. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Microsoft 365 Copilot account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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.

Use Microsoft 365 Copilot from Atomic Agent

With your account connected, ask Atomic Agent to work with Microsoft 365 Copilot in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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