
Perform advanced search with filters and content search
Search for files by content type and properties
Get activity history for files and folders
Search for recently created or modified files
Get the user's default OneDrive
Get information about a specific drive by ID
List all drives available to the user
Get the root folder of a drive
Get a special folder (Documents, Photos, etc.)
Get storage usage information for a drive
Get owner information for a drive
Get a drive item by ID or path
List children of a folder
Create a new folder
Upload a file to OneDrive
Download file content from OneDrive as base64. Set returndownloadurl=true for a short-lived download URL instead, which handles larger files.
Update item metadata
Move an item to a different folder
Copy an item to a different location
Delete an item from OneDrive
Search for items in OneDrive
List permissions for an item
Get a specific permission by ID
Create a sharing link for an item
Grant permissions to recipients for an item
Update roles for a user/group permission
Remove a permission from an item
Access a shared item using sharing URL
Get sharing link information for an item
Check sharing status of an item
Get all available thumbnails for an item
Get a specific thumbnail size for an item
Generate a preview link for an item
Check if thumbnails are available for an item
Get thumbnail URLs for an item
Validate OneDrive credentials. Verifies credentials during setup.
List all versions of a file
Get details of a specific version
Restore a previous version of a file
Compare two versions of a file
List items in the recycle bin
Restore an item from the recycle bin
Get download URL for a specific version of a file

In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}It's an MCP server that connects your agents to individual user file storage within a Microsoft OneDrive GCC High environment via tools. Your agents can invoke these tools to search for files, upload and download documents, manage folder structures, share items with colleagues, and more.
Microsoft doesn't offer an official MCP server for OneDrive GCC High, but you can also use one from a third-party platform, like Merge Agent Handler.
The use cases naturally depend on the agent you've built, but here are a few common ones:
Here are some of the most commonly used tools:
findFileOrFolderInMyOnedrive: searches a user's OneDrive GCC High by keyword or partial file name. Useful for agents that need to locate a specific document before reading its contents or sharing it with another partyreadSmallTextFileFromMyOnedrive: downloads a text file from the user's OneDrive GCC High and returns its contents. Call this when an agent needs to read a document to extract information or summarize its contentscreateSmallTextFileInMyOnedrive: creates and uploads a new text file to the user's OneDrive GCC High. Good for agents that generate reports, draft documents, or need to persist structured output into the user's file storageshareFileOrFolderInMyOnedrive: sends a sharing invitation granting read or write access to a file or folder. Helpful when an agent needs to distribute a deliverable or grant a colleague access to a specific item after completing a taskcreateFolderInMyOnedrive: creates a new folder in the user's OneDrive GCC High. Use this when an agent is organizing files for a new project or preparing a destination before uploading a batch of documentsdeleteFileOrFolderInMyOnedrive: removes a file or folder from the user's OneDrive GCC High. Call this when an agent is cleaning up temporary working files or executing a governed file retention workflowSeveral things distinguish Merge Agent Handler's OneDrive GCC High MCP server from building or using an alternative:
You can take the following steps via Claude Code:
1. Create or log into your Merge Agent Handler account.
2. Install the Merge CLI by running pipx install merge-api, then run merge configure to link the CLI to your Merge account and merge login to authenticate your session.
3. Register the Agent Handler MCP server with Claude Code by running claude mcp add --transport http agent-handler https://ah-api.merge.dev/mcp, then open Claude Code and run /mcp to confirm agent-handler appears with a connected status.
4. Select agent-handler from the MCP list. This opens a browser window where you select which integrations to authenticate. Choose OneDrive GCC High and complete the Microsoft OAuth flow for your GCC High tenant. Merge stores and manages the credentials going forward.
5. Open a Claude Code session and start querying OneDrive GCC High data directly. The first time you use an OneDrive GCC High tool, a Magic Link may appear to complete connector authentication.
If you want to connect Merge Agent Handler's OneDrive GCC High MCP with internal or customer-facing agentic products, you can follow the steps in our docs.
Yes, Merge for Workforce lets your employees connect Claude, ChatGPT, Microsoft Copilot, Cursor, and other MCP-compatible AI tools to OneDrive GCC High without bypassing IT governance.
Instead of setting up direct connections with personal credentials that IT can't monitor or revoke, each employee authenticates through Merge and gets individual credentials tied to their identity. A government contractor, for example, can ask their AI to locate a working draft, share a deliverable with a reviewer, or organize files into a submission folder, all within the access controls IT has established.
IT also provisions access by role or group via SCIM. A program manager, for example, gets OneDrive GCC High access to organize and share project deliverables, SharePoint GCC High to retrieve policy documents, and Outlook to coordinate with agency stakeholders; while a security analyst gets OneDrive GCC High access to store and manage incident reports, ServiceNow to log and track findings, and Microsoft Teams to brief the response team.
Every tool call an employee's AI makes to OneDrive GCC High is also inspected against your DLP rules and logged to a searchable audit trail, giving security teams full visibility into what data was accessed and by whom.
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now