CONNECT APP
Build with Microsoft OneDrive
File Storage
- OAuth
MCP
Give your agent Microsoft OneDrive tools
Every Microsoft OneDrive action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Microsoft OneDrive account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "microsoft_onedrive",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run Create Folder:
const result = await mcp.callTool({
name: "microsoft_onedrive-create-folder",
arguments: {
parentFolderType: "Parent Folder Type",
parentFolderId: "Parent Folder ID",
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "microsoft_onedrive",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Create Folder:
result = await session.call_tool("microsoft_onedrive-create-folder", {
"parentFolderType": "Parent Folder Type",
"parentFolderId": "Parent Folder ID",
})API PROXY
Call the Microsoft OneDrive API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Microsoft OneDrive API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://graph.microsoft.com/v1.0/me",
})
// Any allowed Microsoft OneDrive endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://graph.microsoft.com/v1.0/me
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9ncmFwaC5taWNyb3NvZnQuY29tL3YxLjAvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run Microsoft OneDrive actions from your backend
Connect a user's Microsoft OneDrive account once, then run Create Folder on their behalf from your own code — TypeScript, Python, or plain HTTP.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "microsoft_onedrive-create-folder",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
microsoft_onedrive: { authProvisionId: "apn_xxxxxxx" },
parentFolderType: "Parent Folder Type",
parentFolderId: "Parent Folder ID",
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="microsoft_onedrive-create-folder",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"microsoft_onedrive": {"authProvisionId": "apn_xxxxxxx"},
"parentFolderType": "Parent Folder Type",
"parentFolderId": "Parent Folder ID",
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "microsoft_onedrive-create-folder",
"configured_props": {
"microsoft_onedrive": { "authProvisionId": "apn_xxxxxxx" },
"parentFolderType": "Parent Folder Type",
"parentFolderId": "Parent Folder ID"
}
}'TOOLS
Microsoft OneDrive actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Create Folder
actionCreate a new folder in a drive. See the documentationWritev0.1.3 -
Create Link
actionCreate a sharing link for a DriveItem. See the documentationWritev0.0.5 -
Download File
actionDownload a file stored in OneDrive. See the documentationRead-onlyv0.0.10 -
Find File by Name
actionSearch for a file or folder by name. See the documentationRead-onlyv0.1.1 -
Get File by ID
actionRetrieves a file by ID. See the documentationRead-onlyv0.0.5 -
Get Table
actionRetrieve a table from an Excel spreadsheet stored in OneDrive See the documentationRead-onlyv0.0.7 -
List Files in Folder
actionRetrieves a list of the files and/or folders directly within a folder. See the documentationRead-onlyv0.0.3 -
List My Drives
actionGet the signed-in user's drives. Returns a list of all the drives the user has access to, including the personal OneDrive. See the documentationRead-onlyv0.0.1 -
List Shared Folder Reference Options
actionRetrieves available options for the Shared Folder Reference field.Read-onlyv0.0.1 -
Search Files
actionSearch for files and folders in Microsoft OneDrive. See the documentationRead-onlyv0.1.1 -
Upload File
actionUpload a file to OneDrive. See the documentationWritev0.2.4
EVENTS
Microsoft OneDrive triggers
Event sources your backend can deploy for users and receive through a webhook.
MULTI-APP
Use Microsoft OneDrive with other popular apps
Most products don't stop at one integration. Pair Microsoft OneDrive with the other apps your users rely on, and ship use cases that span both.
REFERENCE
App details
Reference metadata for the Microsoft OneDrive connector in the Pipedream registry.
- App slug
- microsoft_onedrive
- Authentication
- OAuth
- Categories
- File Storage
- Actions
- 11
- Triggers
- 2
- API proxy
- Available
OAuth scopes
These are the scopes Pipedream's managed Microsoft OneDrive OAuth client requests when one of your users connects an account. Supply your own OAuth client to request a different set.
- User.Read
- offline_access
- openid
- profile
- Files.Read
- Files.Read.All
- Files.ReadWrite