Overview
The OneDrive toolset lets AI agents work with files in Microsoft OneDrive (and other drives you can access through Microsoft Graph), including shared libraries, downloads, sharing with people, and basic OneNote notebook operations. It uses delegated OAuth (user consent) so actions run as the signed-in user.Key Capabilities
- Drives and browsing - List drives, open the root folder, list folders and files, and fetch item metadata
- Search - Search within a drive by keyword; search across content shared with you
- Shared with me - List and search files others have shared with you without needing a drive ID first
- File and folder actions - Create folders, rename, move, and copy items (copy may complete asynchronously)
- Sharing - Invite specific people by email with read, write, or owner roles
- Content and links - Get short-lived download URLs; read file content (parsed text and structured output for many formats, subject to size limits)
- New Word files - Create a new
.docxin a folder, optionally with initial text content - OneNote - Create notebooks, sections, and pages; list sections and pages; read page HTML
drive_id. Call get_drives first when the drive is unknown.
Available Tools
Drive and navigation
| Tool | Description |
|---|---|
get_drives | List drives you can use; call first when drive_id is unknown |
get_drive | Get metadata for one drive (for example quota and owner) |
get_root_folder | Get the root drive item for a drive |
get_files | List files and folders under the drive root or a given folder_id |
get_folder_children | List items inside a specific folder |
get_file | Get metadata for one file or folder by item_id |
Search and shared content
| Tool | Description |
|---|---|
search_files | Search a drive by name, content, or metadata |
get_shared_with_me | List items shared with you (no drive_id required) |
search_shared_with_me | Search for a keyword across drives that have shared content with you |
Organize, copy, and share
| Tool | Description |
|---|---|
create_folder | Create a folder under a parent (defaults to root) |
rename_item | Rename a file or folder; preserves the file extension when appropriate |
move_item | Move an item to another folder; optional new name |
copy_item | Copy an item into a destination folder, optionally on another drive or with a new name |
share_item | Share with people by email (read, write, or owner), optional message and invitation options |
Download and read content
| Tool | Description |
|---|---|
get_download_url | Get a short-lived @microsoft.graph.downloadUrl for a file |
get_file_content | Download file bytes and return parsed content (many text and Office-like formats; large files are rejected) |
Create files and OneNote
| Tool | Description |
|---|---|
create_word_file | Create a .docx under a parent folder (file_type must be word); optional content |
create_onenote_notebook | Create a notebook with a display name |
create_onenote_section | Add a section to a notebook identified by its web_url |
create_onenote_page | Add a page to a section by section_id, with optional HTML body |
get_onenote_sections | List sections for a notebook web_url |
get_onenote_pages | List pages in a section |
get_onenote_page_content | Read a page’s HTML by page_id |
Configuration Guide
Setup
Setup
Step 1: Open App registrations from the Azure portal home
- Go to portal.azure.com and sign in.
- On the home page, find Azure services and click App registrations. You can also search the top bar for App registrations or open Microsoft Entra ID and choose App registrations from there.
Step 2: Start a new registration
On the App registrations page, click + New registration.
Step 3: Register the application
- Name: Enter a display name (for example,
PipesHub OneDrive Toolset). - Supported account types: Choose who can sign in—for example Accounts in any organizational directory and personal Microsoft accounts for broad support, or a single-tenant option if you only use your organization.
- Redirect URI: Use the Web redirect URI from the PipesHub Configure OneDrive (or Microsoft 365 files) dialog in toolset settings where OneDrive is set up—for example Workspace → Actions and the OneDrive toolset + Setup / Configure flow.
- Click Register.
Step 4: Copy Application (client) ID and Directory (tenant) ID
On the Overview page for your app, copy:- Application (client) ID — used as Client ID in PipesHub.
- Directory (tenant) ID — used as Tenant ID in PipesHub (or use
common/ leave blank per the toolset dialog if you want both work/school and personal accounts).
Step 5: Create a client secret
- In the left sidebar under Manage, open Certificates & secrets.
- On the Client secrets tab, click + New client secret.
- Add a description, choose an expiration, then click Add.
- Copy the secret value immediately — it is shown only once.
Step 6: Add Microsoft Graph API permissions
- In the left sidebar, open API permissions.
- Click + Add a permission → Microsoft Graph → Delegated permissions.
- Add the permissions your agents need, for example:
| Permission | Description |
|---|---|
Files.ReadWrite.All | Read, write, move, copy, search, and share files the user can reach |
User.Read | Read the signed-in user’s profile |
Notes.Create | Create OneNote notebooks |
Notes.ReadWrite | Read and update OneNote notebooks, sections, and pages |
offline_access | Refresh tokens for ongoing access |
Sites.Read.All or Sites.ReadWrite.All). Start with the table above and add permissions if Graph returns authorization errors for specific drives.The OneDrive toolset uses Delegated permissions so actions run as the signed-in user, not only as the application.
Step 7: Grant admin consent
Click Grant admin consent for your organization (the button includes your tenant name) and confirm, so delegated permissions show as granted for the tenant (especially for permissions that require admin approval).
Step 8: Configure the OneDrive toolset in PipesHub
- In PipesHub, go to Workspace → Actions (or the area where toolsets are configured for your workspace).
- Find OneDrive (or the Microsoft 365 files toolset that includes these tools) and open setup / configuration (+ Setup or Configure).
- Confirm the Redirect URI in the dialog matches the Web redirect URI you registered in Azure Step 3.
- Enter Client ID, Client Secret, and optionally Tenant ID (
commonor your tenant/domain per the form), then create or save the instance.
Step 9: Authenticate the toolset under Your actions
- Open Your actions (or the equivalent entry under Personal in the sidebar).
- Select your OneDrive instance and complete Authenticate with OAuth (Microsoft sign-in, then accept permissions).
Step 10: Add OneDrive to an agent
- Go to the Home page.
- Next to Agents, click + to create a new agent.
- Give the agent a name, drag the OneDrive toolset onto the canvas, connect it to the Agent node with your model and chat input/output, then create the agent.
FAQ
What's the difference between the OneDrive Connector and the OneDrive Toolset?
What's the difference between the OneDrive Connector and the OneDrive Toolset?
| Aspect | OneDrive Connector | OneDrive Toolset |
|---|---|---|
| Purpose | Sync and index files for search in PipesHub | Let agents browse, search, edit metadata, share, and read content through the API |
| Data Flow | One-way import into PipesHub | Two-way actions on live Microsoft 365 content |
| Auth Type | Application permissions (admin consent), background sync | Delegated permissions (user consent), per-user session |
| When to Use | Enterprise search over file corpora | Interactive tasks such as “find this file,” “move to Archive,” or “share with my team” |
Usage Tips
Example: Find a document by nameAsk the agent to search your OneDrive for “Q3 roadmap” (it should resolve
drive_id, then run search_files or browse folders as needed).
Example: Move a file into a folderAsk to move “Budget.xlsx” into the “Archive” folder (the agent can search for IDs, then call
move_item).
Example: Share read-only with a colleagueAsk to share a specific file with
alice@contoso.com with view access.