Skip to main content

SharePoint

Comprehensive SharePoint connector for managing sites, document libraries, lists, and content management through Microsoft Graph API.

What you can ask​

  • Find files in the Sales / Proposals library modified in the last 7 days.
  • Share the Q2 Onboarding site with view-only access to onboarding@acme.com.
  • List documents on the Engineering site last edited over 90 days ago.

Set up​

SharePoint needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find SharePoint. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Microsoft Entra admin center.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or SharePoint login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (6)

Grant the scopes for the tools you plan to allow.

  • Files.Read.All
  • Files.ReadWrite.All
  • Sites.Manage.All
  • Sites.Read.All
  • Sites.ReadWrite.All
  • User.Read

Tools​

SharePoint offers 35 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (21)​

View and search information without changing it.

ToolWhat it does
files_download_itemDownload a file's raw bytes from SharePoint as UTF-8 text or base64, capped at 10 MB; return_download_url=true gives a short-lived URL for larger files.
files_get_drive_itemGet detailed information about a specific file or folder.
files_list_drive_itemsList files and folders in a SharePoint document library folder.
files_read_item_textRead a SharePoint file's contents as text.
files_search_allSearch for files across ALL SharePoint sites and OneDrive.
files_search_drive_itemsSearch for files and folders in a SharePoint document library by query text.
list_get_columnsGet all columns/fields for a SharePoint list.
list_items_get_allGet all items from a SharePoint list.
list_items_get_by_idGet a specific SharePoint list item by ID.
lists_get_by_idGet a SharePoint list by ID.
lists_get_by_titleGet a SharePoint list by its display title.
lists_list_columnsList all columns in a SharePoint list.
sites_get_by_hostnameGet a SharePoint site by hostname (e.g. contoso.sharepoint.com).
sites_get_by_idGet a specific SharePoint site by ID.
sites_get_by_pathGet a SharePoint site by hostname and server-relative path.
sites_get_group_rootGet a Microsoft 365 group's team site.
sites_get_rootGet the organization's default SharePoint root site.
sites_list_columnsList site-level columns for a SharePoint site.
sites_list_drivesList all document libraries (drives) for a SharePoint site.
sites_list_listsList all lists in a SharePoint site.
validate_credentialValidate SharePoint credentials.

Write (5)​

Create or send data.

ToolWhat it does
files_create_folderCreate a new folder in a SharePoint document library.
files_upload_itemUpload a new file to a SharePoint document library.
list_items_createCreate a new item in a SharePoint list.
lists_create_columnCreate a new column in a SharePoint list.
sites_create_listCreate a new SharePoint list.

Delete or overwrite (9)​

Remove or replace existing data.

ToolWhat it does
files_delete_itemDelete a file or folder from a SharePoint document library.
files_update_itemUpdate file or folder name or description.
list_items_deleteDelete a SharePoint list item.
list_items_updateUpdate an existing SharePoint list item.
lists_deleteDelete a SharePoint list and all its items.
lists_delete_columnDelete a column from a SharePoint list.
lists_updateUpdate a SharePoint list's display name or description.
lists_update_columnUpdate a column's display name, description, or required flag.
sites_updateUpdate a SharePoint site's display name or description.
⌘J