# OneDrive — MCP server on mcp.ai
> OneDrive em linguagem natural: busque, leia, crie, mova e compartilhe arquivos e pastas. A plataforma fornece a aplicação OAuth, você só clica em Conectar e escolhe sua conta Microsoft. Várias contas podem ser conectadas no mesmo MCP.

By: mcp.ai · official
Page: https://mcp.ai/one_drive

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_one_drive?ms=1781045700000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/one_drive/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/one_drive/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/one_drive/skill.md
Postman collection (v2.1): https://mcp.ai/one_drive/postman.json

## Tools
- one_drive_copy_item(name?: string, item_id: string, site_id?: string, user_id?: string, drive_id?: string, group_id?: string, children_only?: boolean, parent_reference?: object, include_all_version_history?: boolean, @microsoft.graph.conflictBehavior?: string) — Tool to copy a driveitem (file or folder) to a new location asynchronously. use when you need to duplicate an item, optionally renaming it or specifying a different parent folder. the operation is asy
- one_drive_create_link(type: string, scope?: string, item_id: string, site_id?: string, user_id?: string, drive_id?: string, group_id?: string, password?: string, expiration_date_time?: string, retain_inherited_permissions?: boolean) — Tool to create a sharing link for a driveitem (file or folder) by its unique id. use when you need to generate a shareable link for an item in onedrive or sharepoint.
- one_drive_delete_item(item_id: string, if_match?: string) — Tool to delete a driveitem (file or folder) by its unique id from the authenticated user's onedrive. use when you need to remove an item from onedrive. this action moves the item to the recycle bin, n
- one_drive_download_file(item_id: string, user_id?: string, file_name: string) — Downloads a file from a user's onedrive using its item id, which must refer to a file and not a folder.
- one_drive_get_drive(drive_id: string, select_fields?: string[]) — Retrieves the properties and relationships of a drive resource by its unique id. use this action when you need to get details about a specific onedrive, user's onedrive, group's document library, or a
- one_drive_get_item(item_id: string, drive_id?: string, select_fields?: string[], expand_relations?: string[]) — Retrieves the metadata of a driveitem by its unique id. use this tool to get information about a specific file or folder in onedrive when you have its id. if a `drive id` is not provided, it defaults 
- one_drive_get_item_permissions(select?: string, item_id: string, site_id?: string, user_id?: string, drive_id?: string, group_id?: string, item_path?: string) — Retrieves the permissions of a driveitem by its unique id or path within a specific drive. use when you need to check who has access to a file or folder and what level of access they have.
- one_drive_get_item_thumbnails(select?: string, item_id: string, site_id?: string, user_id?: string, drive_id?: string, group_id?: string, original_orientation?: boolean) — Tool to retrieve the thumbnails associated with a driveitem. use when you need to display visual previews of files.
- one_drive_get_item_versions(item_id: string, site_id?: string, user_id?: string, drive_id?: string, group_id?: string) — Tool to retrieve the version history of a driveitem by its unique id. use when you need to access or list previous versions of a file.
- one_drive_get_quota() — Tool to retrieve the quota information for the authenticated user's onedrive. use this action to check the storage space details like total, used, and remaining space on the user's onedrive.
- one_drive_get_recent_items() — Retrieves a list of items that have been recently used by the authenticated user. this tool is useful when you need to access or display files and folders that the user has interacted with recently ac
- one_drive_get_shared_items(allow_external?: boolean) — Tool to retrieve a list of items that have been shared with the authenticated user. use this action to get details of files and folders shared with the current user.
- one_drive_get_sharepoint_list_items(expand?: string, filter?: string, select?: string, list_id: string, site_id: string) — Tool to get the items (list items) within a specific sharepoint list on a site. use when you need to retrieve data from a sharepoint list.
- one_drive_get_site_details(site_id: string) — Retrieves metadata for a specific sharepoint site by its id. use this action when you need to get details like display name, web url, and creation/modification dates for a known sharepoint site.
- one_drive_get_site_page_content(expand?: string, page_id: string, site_id: string) — Gets the content of a modern sharepoint site page. use when you need to retrieve the details and content of a specific page within a sharepoint site.
- one_drive_invite_user_to_drive_item(roles: string[], item_id: string, message?: string, site_id?: string, user_id?: string, drive_id?: string, group_id?: string, password?: string, recipients: object[], require_sign_in?: boolean, send_invitation?: boolean, expiration_date_time?: string, retain_inherited_permissions?: boolean) — Tool to invite users or grant permissions to a specific item in a onedrive drive. use when you need to share a file or folder with other users and define their access level (e.g., read or write).
- one_drive_list_drive_item_activities($top?: integer, $skip?: integer, $filter?: string, item_id: string, $orderby?: string, drive_id: string) — Tool to list recent activities for a specific item in a onedrive drive. use when you need to track changes or actions performed on a file or folder.
- one_drive_list_drives(top?: integer, expand?: string, select?: string, orderby?: string, site_id?: string, user_id?: string, group_id?: string, skip_token?: string) — Tool to retrieve a list of drive resources available to the authenticated user, or for a specific user, group, or site. use when you need to find out what drives are accessible.
- one_drive_list_root_drive_changes(token?: string) — Tool to list changes in the root of the user's primary drive using a delta token. use when you need to track file and folder modifications, additions, or deletions in the main onedrive directory.
- one_drive_list_sharepoint_list_items_delta(top?: integer, token?: string, expand?: string, select?: string, list_id: string, site_id: string) — Tool to track changes to items in a sharepoint list using a delta query. use when you need to get newly created, updated, or deleted list items without performing a full read of the entire item collec
- one_drive_list_site_columns(top?: integer, skip?: integer, expand?: string, filter?: string, select?: string, orderby?: string, site_id: string) — Tool to list all column definitions for a sharepoint site. use this when you need to retrieve the schema or structure of columns within a specific sharepoint site.
- one_drive_list_site_drive_items_delta(token?: string, site_id: string) — Tool to track changes to driveitems in the default document library of a sharepoint site. use when you need to get a list of items that have been added, modified, or deleted since a previous state or 
- one_drive_list_site_lists(top?: integer, skip?: integer, expand?: string, filter?: string, select?: string, orderby?: string, site_id: string) — Tool to list all lists under a specific sharepoint site. use when you need to enumerate lists within a known site.
- one_drive_list_site_subsites(site_id: string) — Tool to list all subsites of a sharepoint site. use when you need to retrieve a collection of subsites for a given parent site.
- one_drive_list_subscriptions() — Tool to list the current subscriptions for the authenticated user or app. use this to retrieve details of existing webhook subscriptions.
- one_drive_move_item(name?: string, itemId: string, driveId?: string, parentReference: object) — Tool to move a file or folder to a new parent folder in onedrive. use when you need to reorganize your files or folders by changing their location. you can optionally rename the item during the move.
- one_drive_onedrive_create_folder(name: string, user_id?: string, parent_folder?: string) — Creates a new folder in the user's onedrive, automatically renaming on conflict, optionally within a specified parent folder (by id or full path from root) which, if not the root, must exist and be ac
- one_drive_onedrive_create_text_file(name: string, folder?: string, content: string, user_id?: string) — Creates a new text file with specified content in a onedrive folder, using either the folder's unique id or its absolute path (paths are automatically resolved to ids); note that onedrive may rename o
- one_drive_onedrive_find_file(name: string, folder?: string, user_id?: string, include_metadata?: boolean) — Non-recursively finds an item (file or folder) in a specified onedrive folder; if `folder` is provided as a path, it must actually exist.
- one_drive_onedrive_find_folder(name?: string, folder?: string, user_id?: string) — Finds folders by name within an accessible parent folder in onedrive, or lists all its direct child folders if no name is specified.
- one_drive_onedrive_list_items(top?: integer, select?: string[], user_id?: string) — Retrieves all files and folders as `driveitem` resources from the root of a specified user's onedrive, automatically handling pagination.
- one_drive_onedrive_upload_file(file: object, folder?: string, user_id?: string) — Uploads a file to a specified onedrive folder, automatically renaming on conflict and supporting large files via chunking.
- one_drive_preview_drive_item(page?: string, zoom?: number, item_id: string, site_id?: string, user_id?: string, drive_id?: string, group_id?: string, share_id?: string) — Generates or retrieves a short-lived embeddable url for a preview of a specific item. use when you need to display a temporary preview of a file.
- one_drive_search_items(q: string, top?: integer, select?: string, orderby?: string, drive_id?: string, skip_token?: string, search_scope?: string) — Searches for driveitems in onedrive that match the specified query. use this to find files or folders based on keywords.
- one_drive_update_drive_item_metadata(name?: string, item_id: string, site_id?: string, user_id?: string, drive_id?: string, group_id?: string, description?: string, parent_reference_id?: string, additional_properties?: object, parent_reference_drive_id?: string) — Tool to update the metadata of a specific item (file or folder) in onedrive. use this to rename items, change descriptions, or move items to a new parent folder.

## Example prompts
- "Liste os arquivos modificados na última semana"
- "Procure planilhas com 'orçamento' no nome e me dê os links"
- "Crie uma pasta 'Contratos 2026' e mova os PDFs recentes pra lá"

## Links
Docs: https://mcp.ai/docs/mcps/one_drive
Website: https://mcp.ai/mcps/one_drive