For the complete documentation index, see llms.txt. This page is also available as Markdown.

Microsoft 365 OneDrive

Connect your company's OneDrive to Cakewalk through Microsoft's Work IQ OneDrive server, using a Microsoft Entra app you register once.

Connect your company's OneDrive to Cakewalk's MCP Gateway through Microsoft's Work IQ OneDrive server, part of Microsoft Agent 365. Every agent tool call against OneDrive passes through the gateway and is evaluated against your company's Policies.

Cakewalk connects through a Microsoft Entra app that your company registers once and reuses for every Microsoft Work IQ connection. Your admin registers the app, grants it the OneDrive permission, and pastes the Tenant ID, Client ID and secret into Cakewalk. Employees then sign in with their own accounts, so every call runs with that person's own OneDrive access.

The Entra app is shared across all Microsoft Work IQ connections. If you already registered it for another Microsoft connection (Calendar, Mail, Word, Teams or SharePoint), skip Steps 1 and 2 and go straight to Step 3.

Requirements

  • A Microsoft 365 Copilot license for every employee who will use the connection.

  • A Microsoft Entra administrator who can register an app and grant admin consent (Global Administrator, Cloud Application Administrator or Application Administrator).

  • A Cakewalk Admin who can enable the Connection.

Step 1: Enable the Work IQ MCP APIs in your tenant (one time)

The Work IQ servers must be present in your tenant before you can grant permissions to them. Most tenants need this once.

  1. On a machine with PowerShell, download Microsoft's provisioning script: Enable-WorkIQToolsForTenant.ps1.

  2. Run it and sign in with an account that has Entra admin rights and a Microsoft 365 Copilot license.

If the Work IQ APIs already appear when you search in Step 3, you can skip this.

Step 2: Register the Cakewalk Entra app (one time)

  1. Go to the Azure portal and open Microsoft Entra ID.

  2. Go to App registrations and select New registration.

  3. Give it a name, for example CakewalkMcpClient.

  4. Under supported account types, select Accounts in this organizational directory only (single tenant).

  5. Under Redirect URI, choose type Web and enter:

    https://mcp-gateway.getcakewalk.io/api/v1/Auth/Callback
  6. Select Register.

  7. Open Overview and copy the Application (client) ID and the Directory (tenant) ID.

  8. Open Certificates & secrets, select New client secret, give it a name and expiry, and copy the secret Value now. You cannot read it again later.

Step 3: Add the OneDrive permission

In the same Entra app:

  1. Open API permissions, select Add a permission, then APIs my organization uses.

  2. Search for Agent Tools. If nothing appears, search for its app ID ea9ffc3e-8a23-4a7d-836d-234d7c7565c1. If it still does not appear, the Work IQ APIs are not enabled in your tenant yet: complete Step 1 first.

  3. Select the delegated permission McpServers.OneDrive.All and add it.

  4. Select Grant admin consent.

This is the only step that differs per Microsoft Work IQ connection. To add Calendar, Mail, Word, Teams or SharePoint later, reuse the same app and grant that connection's scope here (McpServers.Calendar.All, McpServers.Mail.All, McpServers.Word.All, McpServers.Teams.All, McpServers.SharePoint.All).

Step 4: Connect from Cakewalk

  1. Sign in to Cakewalk as an Admin at https://app.getcakewalk.io.

  2. Go to All Connections and select Add org connection > Choose from catalog.

  3. Select Microsoft 365 OneDrive.

  4. Enter the Directory (tenant) ID, Application (client) ID and client secret you copied in Step 2.

Verifying it works

From an agent platform connected to Cakewalk, ask the agent to list files in your OneDrive. If OneDrive returns results, the connection is live. In Cakewalk, the Microsoft 365 OneDrive card on All Connections shows as active.

Learn more

Last updated

Was this helpful?