Skip to main content
Server path: /microsoft-365-sites | Type: Application | PCID required: Yes

Tools

ToolDescription
microsoft-365-sites_copy_itemCopy a file or folder within (or across) SharePoint document libraries to a destination folder. Optionally rename the copy.
microsoft-365-sites_create_columnAdd a column to a SharePoint list. Provide a Graph column definition object, e.g. { “name”: “Author”, “text”: {} }.
microsoft-365-sites_create_listCreate a new SharePoint list (generic list) in a site. Optionally provide initial column definitions.
microsoft-365-sites_create_site_list_itemCreate an item in a SharePoint list
microsoft-365-sites_delete_columnDelete a column from a SharePoint list. This permanently removes the column and its data.
microsoft-365-sites_delete_listDelete a SharePoint list from a site. This permanently removes the list and all of its items.
microsoft-365-sites_delete_site_list_itemDelete a SharePoint list item
microsoft-365-sites_download_fileDownload a file from a SharePoint document library by drive and item ID. In an agent chat it returns a downloadable file artifact (a signed url plus id/filename/mimeType); in workflow/no-chat mode it returns the file content as base64. For supported document types (PDF, DOCX, PPTX, XLSX) also returns extracted text.
microsoft-365-sites_get_item_by_pathGet a SharePoint drive item (file or folder) by its path within a document library, e.g. “Documents/report.pdf”. Useful when you know the path but not the item ID.
microsoft-365-sites_get_list_by_nameFind a SharePoint list in a site by its display name. Returns matching lists.
microsoft-365-sites_get_list_schemaGet the column definitions (schema) of a SharePoint list.
microsoft-365-sites_get_siteGet a SharePoint site
microsoft-365-sites_get_site_driveGet a site’s document library drive
microsoft-365-sites_get_site_listGet a SharePoint list
microsoft-365-sites_get_site_list_itemGet a SharePoint list item
microsoft-365-sites_list_drivesList the document libraries (drives) available in a SharePoint site. Use a drive ID from this list with the drive-scoped file tools.
microsoft-365-sites_list_folder_contentsRecursively list the contents of a folder in a SharePoint document library (and its subfolders) up to a depth limit. Use folder_path "" or omit it to start at the drive root.
microsoft-365-sites_list_site_list_itemsList items in a SharePoint list
microsoft-365-sites_list_site_listsList SharePoint lists in a site
microsoft-365-sites_list_subsitesList the subsites directly under a SharePoint site.
microsoft-365-sites_move_itemMove a file or folder to a different destination folder within a SharePoint document library. Optionally rename the item.
microsoft-365-sites_search_sitesSearch SharePoint sites
microsoft-365-sites_update_columnUpdate an existing column in a SharePoint list. Provide an object with the column properties to change.
microsoft-365-sites_update_site_list_itemUpdate a SharePoint list item
microsoft-365-sites_upload_fileUpload a file to a SharePoint document library at the given path. Provide the file content as a base64-encoded string. Creates the file or replaces it if one already exists at that path.

microsoft-365-sites_copy_item

Copy a file or folder within (or across) SharePoint document libraries to a destination folder. Optionally rename the copy. Parameters:
ParameterTypeRequiredDefaultDescription
drive_idstringYesThe unique ID of the source document library (drive) containing the item.
item_idstringYesThe unique ID of the item (file or folder) to copy.
parent_idstringYesThe unique ID of the destination folder (drive item) the copy should be placed in.
parent_drive_idstringNoOptional unique ID of the destination drive, if copying to a different document library.
new_namestringNoOptional new name for the copied item.

microsoft-365-sites_create_column

Add a column to a SharePoint list. Provide a Graph column definition object, e.g. { “name”: “Author”, “text”: {} }. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
columnobjectYesThe column definition to create, e.g. { “name”: “Author”, “text”: {} } or { “name”: “Priority”, “number”: {} }.

microsoft-365-sites_create_list

Create a new SharePoint list (generic list) in a site. Optionally provide initial column definitions. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
display_namestringYesThe display name for the new list
descriptionstringNoOptional description for the new list
columnsobject[]NoOptional array of column definitions, e.g. [{ “name”: “Author”, “text”: {} }]

microsoft-365-sites_create_site_list_item

Create an item in a SharePoint list Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
fieldsobjectYesField values for the new list item. Keys are column names, values are the field data.

microsoft-365-sites_delete_column

Delete a column from a SharePoint list. This permanently removes the column and its data. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
column_idstringYesThe unique ID of the column to delete

microsoft-365-sites_delete_list

Delete a SharePoint list from a site. This permanently removes the list and all of its items. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list to delete

microsoft-365-sites_delete_site_list_item

Delete a SharePoint list item Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
item_idstringYesThe unique ID of the list item to delete

microsoft-365-sites_download_file

Download a file from a SharePoint document library by drive and item ID. In an agent chat it returns a downloadable file artifact (a signed url plus id/filename/mimeType); in workflow/no-chat mode it returns the file content as base64. For supported document types (PDF, DOCX, PPTX, XLSX) also returns extracted text. Parameters:
ParameterTypeRequiredDefaultDescription
drive_idstringYesThe unique ID of the SharePoint document library (drive). Get it from list_drives or get_site_drive.
item_idstringYesThe unique ID of the drive item (file) to download.
extract_textbooleanNoWhether to extract text for supported document types (default true). Set false to return only the base64 content.

microsoft-365-sites_get_item_by_path

Get a SharePoint drive item (file or folder) by its path within a document library, e.g. “Documents/report.pdf”. Useful when you know the path but not the item ID. Parameters:
ParameterTypeRequiredDefaultDescription
drive_idstringYesThe unique ID of the SharePoint document library (drive). Get it from list_drives or get_site_drive.
pathstringYesPath to the item relative to the drive root, e.g. “Documents/report.pdf” or “Photos”.

microsoft-365-sites_get_list_by_name

Find a SharePoint list in a site by its display name. Returns matching lists. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_namestringYesThe display name of the SharePoint list to find

microsoft-365-sites_get_list_schema

Get the column definitions (schema) of a SharePoint list. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list

microsoft-365-sites_get_site

Get a SharePoint site Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site, or “root” for the root site
$selectstringNoComma-separated properties to return

microsoft-365-sites_get_site_drive

Get a site’s document library drive Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site

microsoft-365-sites_get_site_list

Get a SharePoint list Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
$expandstringNoExpand related resources (e.g. “columns” to include column definitions)

microsoft-365-sites_get_site_list_item

Get a SharePoint list item Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
item_idstringYesThe unique ID of the list item
$expandstringNoExpand related resources (use “fields” to include item field values)

microsoft-365-sites_list_drives

List the document libraries (drives) available in a SharePoint site. Use a drive ID from this list with the drive-scoped file tools. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site

microsoft-365-sites_list_folder_contents

Recursively list the contents of a folder in a SharePoint document library (and its subfolders) up to a depth limit. Use folder_path "" or omit it to start at the drive root. Parameters:
ParameterTypeRequiredDefaultDescription
drive_idstringYesThe unique ID of the SharePoint document library (drive). Get it from list_drives or get_site_drive.
folder_pathstringNoPath to the starting folder relative to the drive root, e.g. “Documents”. Omit or "" for the root.
max_depthintegerNoMaximum recursion depth (default 3). 0 lists only the immediate folder.
max_resultsintegerNoMaximum number of items to return across all levels (default 200).

microsoft-365-sites_list_site_list_items

List items in a SharePoint list Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
$expandstringNoExpand related resources (use “fields” to include item field values)
$filterstringNoOData filter expression to filter items by field values
$topintegerNoNumber of items to return
$selectstringNoComma-separated properties to return

microsoft-365-sites_list_site_lists

List SharePoint lists in a site Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
$selectstringNoComma-separated properties to return (e.g. “id,displayName,description,list”)

microsoft-365-sites_list_subsites

List the subsites directly under a SharePoint site. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the parent SharePoint site

microsoft-365-sites_move_item

Move a file or folder to a different destination folder within a SharePoint document library. Optionally rename the item. Parameters:
ParameterTypeRequiredDefaultDescription
drive_idstringYesThe unique ID of the document library (drive) containing the item.
item_idstringYesThe unique ID of the item (file or folder) to move.
parent_idstringYesThe unique ID of the destination folder (drive item) to move the item into.
new_namestringNoOptional new name for the item.

microsoft-365-sites_search_sites

Search SharePoint sites Parameters:
ParameterTypeRequiredDefaultDescription
$searchstringNoSearch query string (e.g. “marketing”, “hr”, “finance”)
$topintegerNoNumber of sites to return (max 200)
$selectstringNoComma-separated properties to return

microsoft-365-sites_update_column

Update an existing column in a SharePoint list. Provide an object with the column properties to change. Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
column_idstringYesThe unique ID of the column to update
updatesobjectYesThe column properties to update, e.g. { “displayName”: “New Name” }.

microsoft-365-sites_update_site_list_item

Update a SharePoint list item Parameters:
ParameterTypeRequiredDefaultDescription
site_idstringYesThe unique ID of the SharePoint site
list_idstringYesThe unique ID of the SharePoint list
item_idstringYesThe unique ID of the list item to update
fieldsobjectNoField values to update. Only include the fields you want to change.

microsoft-365-sites_upload_file

Upload a file to a SharePoint document library at the given path. Provide the file content as a base64-encoded string. Creates the file or replaces it if one already exists at that path. Parameters:
ParameterTypeRequiredDefaultDescription
drive_idstringYesThe unique ID of the SharePoint document library (drive). Get it from list_drives or get_site_drive.
pathstringYesDestination path in the drive including the filename, e.g. “report.pdf” for the root or “Documents/2024/report.pdf” for a subfolder.
content_base64stringYesThe file content, encoded as a base64 string.