Cloud Storage
OneDrive
API integration
Ship Cloud Storage features without building the integration. Full OneDrive API access via Proxy, normalized data through Unified APIs, and 10+ MCP-ready tools for AI agents — all extensible to your exact use case.
Talk to usUse Cases
Why integrate with OneDrive
Common scenarios for SaaS companies building OneDrive integrations for their customers.
Permission-aware document ingestion for AI knowledge platforms
Enterprise AI SaaS companies can crawl and download OneDrive files via Truto, then sync file-level permissions to ensure their AI assistant only surfaces answers from documents the querying user is authorized to access.
Centralized file browsing for project management tools
Project management platforms can embed a native OneDrive file browser so users navigate drives, folders, and files without leaving the app — attaching documents to tasks or projects by reference rather than forcing re-uploads.
Federated search across cloud storage from within your app
SaaS products can embed OneDrive's native search directly into their own search bar, letting users find Microsoft 365 documents without switching tabs or context.
Compliance-driven document linking for legal and HR platforms
Regulated-industry SaaS companies can let users link OneDrive documents to internal records (cases, candidates, contracts) while keeping files in the Microsoft 365 environment that IT already trusts for DLP and eDiscovery.
Automated file sync and change detection for backup and ETL pipelines
Data platforms can poll OneDrive drive items for metadata changes (eTag, lastModifiedDateTime) and selectively re-download only updated files, reducing bandwidth and keeping downstream systems current.
What You Can Build
Ship these features with Truto + OneDrive
Concrete product features your team can ship faster by leveraging Truto’s OneDrive integration instead of building from scratch.
In-app OneDrive folder tree navigator
Render a fully navigable folder structure using list_all_onedrive_drives, list_all_onedrive_root, and list_all_onedrive_drive_items so end users can browse and select files without leaving your product.
Permission-mirrored document access layer
Sync OneDrive sharing permissions into your app using list_all_onedrive_drive_item_permissions to enforce the same access controls your customers already manage in Microsoft 365.
Embedded cross-drive document search
Let users search across their OneDrive files directly from your app's UI using list_all_onedrive_search_drive_items, returning relevant hits with summaries powered by Microsoft's native search index.
Selective file download and content ingestion pipeline
Download file contents on demand via onedrive_drive_items_download or get_single_onedrive_drive_item_content_download_by_id to feed documents into RAG pipelines, OCR workflows, or reporting engines.
User identity mapping between your app and Microsoft 365
Automatically resolve your app's users to their Microsoft identities using list_all_onedrive_users and list_all_onedrive_me, ensuring API actions and audit trails are correctly attributed.
Storage quota dashboard for admin consoles
Surface drive-level storage usage and quota information retrieved via get_single_onedrive_drive_by_id so IT admins using your platform can monitor capacity without switching to the Microsoft admin center.
SuperAI
OneDrive AI agent tools
Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.
list_all_onedrive_me
Retrieves the profile information of the currently authenticated user, including their ID, name, email, and userPrincipalName
list_all_onedrive_drives
List drives for a user in OneDrive. Requires user_id. Returns id, driveType, name, and owner with user id and displayName for each drive.
get_single_onedrive_drive_by_id
Get a drive by id in OneDrive. Returns id, driveType, owner user id and displayName, and quota details including deleted, fileCount, remaining, state, and total.
list_all_onedrive_drive_items
List DriveItem by drive_id and item_id in OneDrive. Returns an array of driveItem objects including name, size, and folder childCount if applicable.
get_single_onedrive_drive_item_by_id
Get metadata for a specific DriveItem by id in OneDrive using drive_id and id. Returns fields like createdBy, createdDateTime, cTag, eTag, folder childCount, id, lastModifiedBy, lastModifiedDateTime, name, size, and webUrl.
onedrive_drive_items_download
Use this endpoint to download a file from the specified resource path. It retrieves the binary content of a file stored and returns it as a direct file download.
list_all_onedrive_search
Run a search query in OneDrive with a JSON body containing requests specifying entityTypes, contentSources, region, query, from, size, and fields. Returns search terms, hits with hitId, rank, summary, and resource details.
get_single_onedrive_drive_item_content_download_by_id
Download the contents of a DriveItem file in OneDrive using id. Returns a 302 redirect to a pre-authenticated download URL in the Location header.
list_all_onedrive_drive_item_permissions
List effective sharing permissions on a DriveItem in OneDrive by id. Returns permissions including roles, link details, grantedTo user info, and inheritedFrom ancestor reference.
list_all_onedrive_users
List users in OneDrive. Returns user properties including businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, and userPrincipalName.
get_single_onedrive_user_by_id
Get information about a specific user in OneDrive. Requires id. Returns default user properties including businessPhones, displayName, givenName, id, jobTitle, mail, mobilePhone, officeLocation, preferredLanguage, surname, and userPrincipalName.
list_all_onedrive_search_drive_items
Search DriveItems in OneDrive root drive using query q. Returns matching DriveItems with id, name, folder info, and searchResult.onClickTelemetryUrl fields.
list_all_onedrive_root
Get metadata for the root DriveItem in OneDrive. Returns fields including id, name, size, createdBy, lastModifiedBy, createdDateTime, lastModifiedDateTime, folder childCount, and webUrl.
Why Truto
Why use Truto’s MCP server for OneDrive
Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 650+ integrations.
Auto-generated, always up to date
Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.
Fine-grained access control
Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.
Multi-tenant by design
Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.
Works with every MCP client
Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.
Built-in auth, rate limits, and error handling
Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.
Expiring and auditable servers
Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.
Unified APIs
Unified APIs for OneDrive
Skip writing code for every integration. Use Truto’s category-specific Unified APIs out of the box or customize the mappings with AI.
Unified User Directory API
Unified File Storage API
Drive-Items
Drive Items are the files and folders present in a file storage system. These items are usually part of a Drive. You can differentiate between files and folders using the type attribute.
Drives
Drives is a collection of files and folders. They could have multiple Drive Items within them. Users could have multiple Drives accessible to them in a file storage system.
Permissions
Permissions can answer your questions around which User has access to do what on a Drive Item or a Drive.
Users
Users represent the people using the underlying file storage system.
Unified Search API
Search
Search endpoint for all the apps.
How It Works
From zero to integrated
Go live with OneDrive in under an hour. No boilerplate, no maintenance burden.
Link your customer’s OneDrive account
Use Truto’s frontend SDK to connect your customer’s OneDrive account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.
We handle authentication
Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.
Call our API, we call OneDrive
Truto’s Proxy API is a 1-to-1 mapping of the OneDrive API. You call us, we call OneDrive, and pass the response back in the same cycle.
Unified response format
Every response follows a single format across all integrations. We translate OneDrive’s pagination into unified cursor-based pagination. Data is always in the result attribute.
FAQs
Common questions about OneDrive on Truto
Authentication, rate limits, data freshness, and everything else you need to know before you integrate.
What authentication method does the OneDrive integration use?
Truto handles OAuth 2.0 authentication with Microsoft's identity platform (Entra ID) on your behalf. Your end users go through a standard consent flow to connect their OneDrive account, and Truto manages token refresh and storage automatically.
Can I download actual file contents, or only metadata?
Both. You can retrieve rich metadata (name, size, eTag, last modified, created by) via get_single_onedrive_drive_item_by_id, and download the binary file content using onedrive_drive_items_download or get_single_onedrive_drive_item_content_download_by_id.
How does Truto handle pagination when listing large OneDrive directories?
Truto abstracts Microsoft Graph's pagination (which uses @odata.nextLink tokens) into a consistent interface. When you call list endpoints like list_all_onedrive_drive_items, Truto handles cursor-based pagination so you can iterate through all results without managing page tokens yourself.
Can I read file-level sharing permissions?
Yes. The list_all_onedrive_drive_item_permissions endpoint returns the effective permissions for a given drive item, including roles and the identities (users, groups, links) they are granted to. This is essential for building permission-aware features.
Does the integration support both personal OneDrive and OneDrive for Business?
The integration works with OneDrive for Business accounts connected through Microsoft 365. You can discover all available drives (personal and shared) for an authenticated user via list_all_onedrive_drives.
Which Truto Unified APIs cover OneDrive?
OneDrive is covered by three Unified APIs: the Unified File Storage API (drives, drive items, permissions, users), the Unified User Directory API (users, me, licenses, roles), and the Unified Search API (search across drive items). This means switching between OneDrive and other cloud storage providers requires minimal code changes.
OneDrive
Get OneDrive integrated into your app
Our team understands what it takes to make a OneDrive integration successful. A short, crisp 30 minute call with folks who understand the problem.
Talk to us