How to integrate One drive MCP with Grok Build

Connect Grok Build to One drive MCP. Share project folder with your team, download the latest version of report.docx, and more from your terminal, with authentication handled for you.

One drive logoOne drive
Oauth2S2s Oauth2

OneDrive is Microsoft’s cloud storage for storing, syncing, and sharing files across devices. Access your files securely anywhere with real-time collaboration and offline support.

101 Tools9 Triggers

How to integrate One drive MCP with Grok Build

Grok Build is xAI's terminal coding agent. It runs on Grok 4.5, plans its work before it acts, and can run multiple sub-agents in parallel. It also reads Claude Code's MCP configuration, so any server you already have in a .mcp.json is picked up with no changes.

In this guide, I will show you how to connect your One drive account to Grok Build through Composio, so it can share project folder with your team, download the latest version of report.docx, check who can access budget.xlsx, and more without leaving the terminal. Composio holds the OAuth tokens for you, and Grok Build only calls the tools you approve.

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

Also integrate One drive with

Why use Composio over a standalone MCP server?

  • Read and write access. Composio's One drive integration lets Grok Build take real actions like creating drafts, sending updates, and labeling records, not just reading data.
  • 1,700+ SaaS toolkits out of the box. One endpoint gives you a full catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
  • One MCP server for every app. Wire up a single Composio server instead of maintaining a separate MCP entry for each app.
  • Smart, context-aware tool loading. Grok Build caps how many tools it holds in a single request. Composio loads only the tools a task needs, so you do not spend that budget on tools you are not using.
  • Cross-app automation. Chain actions across apps in one run. Pull a thread, summarize it in Notion, and post the highlights to Slack from a single prompt.

Prerequisites

  • Grok Build installed and signed in. Install with curl -fsSL https://x.ai/cli/install.sh | bash on macOS or Linux, or irm https://x.ai/cli/install.ps1 | iex on Windows PowerShell. On first launch Grok opens a browser to authenticate; for headless or CI use, set an XAI_API_KEY environment variable instead (create the key at console.x.ai).
  • Access to the One drive account you want to connect.
  • The Composio MCP endpoint. Composio's server is remote and hosted, so there is nothing to run locally and no tunnel to set up.

Step-by-step: Connect One drive to Grok Build

1. Install and verify Grok Build

Install the CLI, then restart your shell so the grok binary lands on your PATH:

bash
curl -fsSL https://x.ai/cli/install.sh | bash
which grok

On Windows, install with PowerShell instead: irm https://x.ai/cli/install.ps1 | iex. If which grok returns a path, you are set. Grok Build runs on Grok 4.5 by default; you can switch models inside the session with /model <name>.

2. Add the Composio server

Add Composio as a remote HTTP MCP server with the grok mcp add command:

bash
grok mcp add --transport http composio https://connect.composio.dev/mcp

You can also add and manage servers from inside a session. Run /mcps to open the extensions modal on the MCP tab, then add a new server and paste the Composio URL. Added this way, Grok auto-detects the name from the URL and lists the server as connect:

bash
https://connect.composio.dev/mcp
Grok Build /mcps extensions modal listing MCP servers Grok Build adding the Composio MCP server with its URL

Grok also reads Claude Code-style config, so an entry in ~/.grok/config.toml or a project .mcp.json works the same way.

3. Authenticate

Composio uses OAuth. In the /mcps modal, select the Composio server and press i to authenticate (Grok also triggers this browser flow automatically the first time it uses a Composio tool). Click Allow to authorize access. Grok stores the tokens under ~/.grok/mcp_credentials.json, and /mcps shows Composio as connected.

Grok Build prompting to authenticate the Composio MCP server Composio authorization screen with the Allow button for Grok Build

4. Start building

Ask Grok to work with your One drive account through Composio. On the first One drive action, Composio prompts you to connect the account through OAuth. Approve the scopes once, and Composio handles token refresh from there.

What you can do after connecting One drive

  • Share project folder with your team
  • Download the latest version of report.docx
  • Check who can access budget.xlsx
  • List your remaining OneDrive storage space

Security + privacy notes (important)

  • Use least-privilege access. Grant only the One drive scopes you actually need.
  • Review OAuth scopes before approving. Check that the requested scopes match what you expect Composio and Grok Build to do.
  • Keep write actions human-reviewed. Grok Build proposes a plan before it acts. Leave that approval step on for actions like sending messages or editing records.
  • Keep secrets out of version control. Your XAI_API_KEY and any tokens should never be committed. Use environment variables or a secrets manager.
TOOLS & TRIGGERS

Supported Tools and Triggers

Every One drive action and event your agent gets out of the box.

Add Workbook Worksheet

Adds a new worksheet to an existing Excel workbook in OneDrive or SharePoint.

Calculate Workbook

Recalculate formulas in an Excel workbook at the requested depth.

Check In Drive Item

Tool to check in a checked out driveItem resource, making the version of the document available to others.

Checkout Drive Item

Tool to check out a driveItem to prevent others from editing it and make your changes invisible until checked in.

Clear Workbook Range

Clears values, formats, or both from a worksheet range in an Excel workbook stored in OneDrive or SharePoint without deleting cells or shifting neighboring data.

Close Workbook Session

Close an Excel workbook session without deleting the workbook.

Copy Item

Copies a DriveItem file or folder, optionally renaming it or specifying a destination folder.

Create Drive Item Permission

Tool to create a new permission on a OneDrive drive item.

Create Sharing Link

Tool to create a sharing link for a DriveItem (file or folder) by its unique ID.

Create SharePoint List Item

Create an item in a SharePoint list using Microsoft Graph through the OneDrive connection.

Create Upload Session

Create only a resumable upload session for a named file; this action does not upload bytes.

Create Upload Session By Path

Create only a resumable upload session at a root-relative path; this action does not upload bytes.

Create Workbook Session

Create a persistent or temporary session for an Excel workbook.

Delete Item

Delete a DriveItem (file or folder) by ID from a specified drive or user's OneDrive, defaulting to the authenticated user's drive.

Permanently Delete Drive Item

Tool to permanently delete a driveItem by its ID without moving it to the recycle bin.

Delete Drive Item Permission

Tool to delete a permission from a drive item.

Delete Shares Permission

Tool to delete the permission navigation property for a shared drive item.

Delete SharePoint Item Permission

Revoke a Microsoft Graph beta permission from a SharePoint list or list item.

Delete Workbook Range

Deletes a range of cells from an Excel worksheet in OneDrive, shifting remaining cells up or left to fill the gap.

Delete Workbook Worksheet

Deletes a worksheet from a workbook in OneDrive by its ID or name.

Discard Checkout

Tool to discard the checkout of a driveItem, releasing it and discarding any changes made while checked out.

Download a file

Downloads a file from a user's OneDrive using its item ID, which must refer to a file and not a folder.

Download file by path

Downloads the contents of a file from OneDrive by its path.

Download item as format

Tool to download the contents of a driveItem converted to a specific format (e.g., PDF or HTML).

Download Item Thumbnail

Download thumbnail image bytes for a DriveItem identified by item ID.

Download Drive Item Version Content

Tool to download the contents of a specific previous version of a drive item (file).

Download Thumbnail by Path

Download thumbnail image bytes for a path-addressed item in the current user's OneDrive.

Follow Drive Item

Tool to follow a driveItem (file or folder) in OneDrive or SharePoint.

Format Workbook Range

Apply dimensions, alignment, wrapping, font, fill, and borders to a workbook range.

Get document comments

Extracts comments from a Word .docx file in OneDrive.

Get Drive

Retrieves properties and optionally expanded relationships of a Drive resource, including a specific drive or a user's, group's, or site's drive.

Get DriveItem by Sharing URL

Resolve a OneDrive or SharePoint sharing URL or share ID to drive item metadata and available IDs.

Get Drive Item List Item

Retrieve the SharePoint list item associated with a driveItem.

Get Drives Following

Tool to retrieve a specific followed driveItem from a drive.

Get Group Drive

Tool to retrieve the document library (drive) for a Microsoft 365 group.

Get Item Metadata

Retrieves the metadata of a DriveItem by its unique ID.

Get Item by Path

Retrieve OneDrive or SharePoint driveItem metadata by drive-relative path.

Get Item Permissions

Retrieve a page of permissions for a DriveItem by ID, or by path in the current user's drive.

Get Item Thumbnails

Tool to retrieve the thumbnails associated with a DriveItem.

Get Item Versions

Tool to retrieve the version history of a DriveItem by its unique ID.

Get Drive Root Folder

Retrieve metadata for the root folder of the signed-in user's OneDrive or a specified user's OneDrive, such as size, child count, or web URL.

Get Shared Item by ShareId

Tool to access a shared DriveItem or collection of shared items using a shareId or encoded sharing URL.

Get SharePoint List Items

Tool to get the items (list items) within a specific SharePoint list on a site.

Get Site Details

Retrieves metadata for a specific SharePoint site by its ID.

Get SharePoint Site Page Content

Gets the content of a modern SharePoint site page.

Get Drive Special Folder

Tool to retrieve a special folder in OneDrive by name.

Get User Profile

Retrieves profile properties for a Microsoft user by user ID or user principal name, including available contact details, job information, and account status.

Get Workbook Range Fill

Read the fill color applied to an Excel worksheet range.

Get Workbook Used Range

Retrieves the used range of a worksheet in an Excel workbook stored in OneDrive or SharePoint without requiring the caller to know an explicit A1 range address.

Get Workbook Worksheet

Retrieves a specific worksheet from an Excel workbook stored in OneDrive or SharePoint using Microsoft Graph API.

Grant Shares Permission

Tool to grant users access to a link represented by a permission using an encoded sharing URL.

Grant SharePoint Item Permission

Grant an application permission on a SharePoint list or list item using Microsoft Graph beta.

Inspect Workbook Table

Read a workbook table's occupied range and one page of its columns.

Invite User to Drive Item

Invite users or grant permissions to a OneDrive file or folder with specified access roles.

List Drive Activities

Tool to retrieve recent activities on the authenticated user's OneDrive.

List All Drive Items

Lists a complete OneDrive or SharePoint drive safely, one Microsoft Graph delta page per invocation.

List Drive Bundles

Tool to retrieve a list of bundle resources from a specified drive.

List Drives

Tool to retrieve a list of Drive resources available to the authenticated user, or for a specific user, group, or site.

List Folder Children

List the direct children (files/folders) of a OneDrive/SharePoint folder by DriveItem ID or path.

List Followed Sites

List SharePoint sites followed by the signed-in organizational user.

List Drive Item Activities

Tool to list recent activities for a specific item in a OneDrive drive.

List OneDrive Shared Items

List files shared from other people's OneDrive accounts using Microsoft Graph Search match-all and a OneDrive-personal URL heuristic.

List Root Drive Changes

List drive item changes using Microsoft Graph delta, including additions, modifications and deletions, for a specified drive or the current user's drive.

List Shared Drive Item Children

List one page of children beneath a folder addressed by a sharing link.

List Shares Permission

Tool to retrieve permission details for a shared OneDrive or SharePoint item using a share ID.

List SharePoint Item Permissions

List Microsoft Graph beta permissions from a SharePoint list or list item.

List SharePoint List Items Delta

Tool to track changes to items in a SharePoint list using a delta query.

List Site Columns

Tool to list all column definitions for a SharePoint site.

List Site Drive Items Delta

Tool to track changes to DriveItems in the default document library of a SharePoint site.

List Site Lists

Tool to list all lists under a specific SharePoint site.

List Site Recycle Bin Items

Return one page of deleted items from a SharePoint site's recycle bin.

List Site Subsites

Lists subsites of a SharePoint site for an organizational Microsoft 365 account.

List Subscriptions

Lists current webhook subscriptions for the authenticated user or app, one page at a time.

List Workbook Names

List defined names and formulas in an Excel workbook.

List Workbook Worksheets

Retrieves a list of all worksheets in an Excel workbook stored in OneDrive or SharePoint.

Move Item

Tool to move a file or folder to a new parent folder in OneDrive.

Create folder

Creates a new folder in the user's OneDrive with configurable conflict behavior, optionally within a specified parent_folder (by ID or full path from root) which, if not the root, must exist and be accessible.

Create a new text file

Creates a plain-text file in a user's OneDrive folder, identified by ID or path.

Find Item

Find files or folders by exact name within a specified OneDrive folder, without searching subfolders.

Find Folder

Find direct child folders in a OneDrive parent folder, optionally matching an exact name.

List OneDrive items

Lists one page of files and folders at the root of a user's OneDrive without recursively listing subfolders.

Upload file

Uploads a file to a OneDrive or SharePoint folder using chunked uploads, creating missing destination folders as needed.

Preview Drive Item

Generates or retrieves a short-lived, permission-bound embeddable URL for a preview of a specific item.

Read Workbook Range

Reads a range of cells from an Excel workbook worksheet stored in OneDrive or SharePoint using Microsoft Graph API.

Restore Deleted Item

Tool to restore a deleted OneDrive driveItem (file or folder) from the recycle bin.

Restore Item Version

Restores a previous version of a DriveItem (file) by creating a new version with the content of the specified version.

Revoke Sharing Link Grants

Remove selected recipients from a work or school specific-user sharing link.

Search Drive Items

Search OneDrive and accessible SharePoint files with Microsoft Graph Search.

Search Items

Search OneDrive files and folders by keyword, with sorting and pagination.

Search SharePoint Sites

Search SharePoint sites visible to an organizational Microsoft account.

Track Folder Changes

Track changes beneath one folder, one Microsoft Graph delta page at a time.

Delete Drive Following

Tool to unfollow a driveItem by removing it from the user's followed items collection.

Update Drive Item Metadata

Tool to update the metadata of a specific item (file or folder) in OneDrive.

Update Drive Item Permissions

Tool to update the roles of an existing permission on a OneDrive drive item.

Update File Content

Tool to update an existing file's content in OneDrive.

Update SharePoint Item Permission

Update an application permission on a SharePoint list or list item using Microsoft Graph beta.

Update SharePoint List Item Fields

Update field values on a SharePoint list item using Microsoft Graph through the OneDrive connection.

Update Table Column Range

Update values, formulas, number formats, or row and column visibility in a table column's whole or data-body range.

Update Workbook Range

Updates a range in a workbook worksheet using Microsoft Graph API.

Update Workbook Worksheet

Updates properties of a worksheet in an Excel workbook stored in OneDrive.

Write Workbook Cell

Updates the value, formula, or format of a specific cell in an Excel workbook stored in OneDrive.

FAQ

Frequently asked questions

Start with One drive.It takes 30 seconds.

Managed auth, hosted MCP servers, and every One drive tool your agent needs.Free to start.

Start building