SharePoint MCP
for AI agents

• add_attachment_to_list_item write

  Add Attachment to List Item

  Tool to add an attachment to a SharePoint list item. Use when you need to upload a binary file as an attachment to a specified list item.

• add_field_link_to_content_type write

  Add Field Link to Content Type

  Tool to add a field link to a list content type. Use when you want to associate an existing list field with a content type.

• add_role_assignment_to_item write

  Add Role Assignment to List Item

  Tool to add a role assignment to a list item. Use when granting specific permissions to a user or group after breaking inheritance if needed. This action is externally visible and permanently alters item permissions; obtain explicit human approval for the target item and `role_definition_id` before executing.

• add_role_assignment_to_list write

  Add Role Assignment to SharePoint List

  Tool to add a role assignment to a SharePoint list. Requires the list to have broken role inheritance first via SHARE_POINT_BREAK_ROLE_INHERITANCE_ON_LIST; inheriting lists will reject unique role assignments. Use when granting permissions to a user or group on a specific list.

• break_role_inheritance_on_item write

  Break Role Inheritance on List Item

  Tool to break permission inheritance on a list item. Call this before adding new role assignments; adding assignments prior leaves the item still inheriting parent permissions, causing unexpected access behavior. Use when you need to uniquely set permissions on an item after copying or clearing parent assignments.

• break_role_inheritance_on_list write

  Break Role Inheritance on List

  Breaks permission inheritance on a SharePoint list, allowing you to set unique permissions. When you break inheritance, you can choose to: - Copy parent permissions as a starting point (copy_role_assignments=true) - Start fresh with no inherited permissions (copy_role_assignments=false) - Clear unique permissions on child items to re-inherit from this list (clear_subscopes=true) Use this when you need to manage list-level permissions independently from the site. Must be called before SHARE_POINT_ADD_ROLE_ASSIGNMENT_TO_LIST, which fails on lists still inheriting from the parent site.

• check_in_file write

  Check In SharePoint File

  Tool to check in a file. Use after uploading or editing a document and you're ready to finalize changes.

• create_content_type write

  Create Content Type

  Tool to create a new content type in SharePoint. Use when you need to define a custom content type with specific metadata structure for lists or libraries.

• create_drive_item_sharing_link write

  Create Drive Item Sharing Link

  Tool to create a sharing link for a drive item in SharePoint or OneDrive. Use when you need to generate a shareable link with specific permissions (view/edit/embed) and scope (anonymous/organization/users). The link can optionally include password protection and expiration date.

• create_list_field write

  Create SharePoint List Field

  Tool to create a new field (column) in a SharePoint list. Use when you need to programmatically add a column after confirming the list GUID.

• create_list_item_by_id write

  Create SharePoint List Item by GUID

  Tool to create a new item in a SharePoint list using the list's GUID. Use when you have the list GUID rather than the list title.

• create_list_item_in_folder write

  Create List Item in Folder

  Tool to create a list item in a specific folder within a SharePoint list. IMPORTANT: This action works ONLY with SharePoint lists (not document libraries). The folder_url can be either a server-relative URL (e.g., '/Lists/MyList') or an absolute URL (e.g., 'https://site.sharepoint.com/sites/sitename/Lists/MyList'). To create files in document libraries, use a different action like upload_file.

• create_web write

  Create SharePoint Subsite

  Tool to create a new SharePoint subsite under the current site. Use when you need to create a new subsite with specific settings for permissions, language, and template.

• delete_drive_item_version_content write

  Delete Drive Item Version Content

  Tool to delete content for a specific version of a drive item in SharePoint. Use when you need to remove the binary content associated with a particular version of a file while keeping the version metadata.

• delete_file_item write

  Delete SharePoint File

  Deletes a file from a SharePoint document library permanently. This action removes the specified file and moves it to the site's recycle bin. Use this when you need to remove files that are no longer needed. This action is irreversible — the file cannot be recovered once removed from the recycle bin. The operation is idempotent - attempting to delete a non-existent file will succeed without error. Requires the server-relative path of the file (e.g., '/Shared Documents/FileName.ext').

• delete_folder write

  Delete SharePoint Folder

  Deletes a folder from a SharePoint document library. This action permanently removes the specified folder and moves it to the site's recycle bin. Use this when you need to remove folders that are no longer needed. The operation is idempotent - attempting to delete a non-existent folder will succeed without error. Requires the server-relative path of the folder (e.g., '/Shared Documents/FolderName').

• delete_list write

  Delete SharePoint List

  Tool to delete a SharePoint list. Use when you need to remove a list by its GUID after confirming the correct list identifier.

• delete_list_by_title write

  Delete SharePoint List By Title

  Tool to delete a SharePoint list by its title. Use when you need to permanently remove a list and all its contents by specifying the list name.

• delete_list_item write

  Delete SharePoint List Item

  Tool to delete a SharePoint list item. Use when you need to permanently remove an item by its ID. Use after obtaining the item's ETag to ensure concurrency control.

• delete_list_items write

  Delete Multiple SharePoint List Items

  Tool to delete multiple SharePoint list items in bulk. Use when you need to permanently remove multiple items by their IDs. This action is irreversible - deleted items cannot be recovered. For recoverable deletion, use the recycle action instead. Use this action when you have a list of item IDs to delete from the same list.

• delete_recycle_bin_item_permanent write

  Delete Recycle Bin Item Permanently

  Tool to permanently delete a SharePoint Recycle Bin item. Use after confirming the item's GUID to remove it irrevocably.

• download_file_by_server_relative_url read

  Download File by Server-relative URL

  Tool to download a file by server-relative URL. Use when you need to fetch the raw bytes of a SharePoint file by its server-relative path.

• ensure_user write

  Ensure SharePoint User

  Ensures a user exists in a SharePoint site by their login name. If the user already exists, returns their info; if not, adds them to the site — this is a write operation with a provisioning side effect, not a read-only presence check. Use when you need to add a user or get their user ID for permissions. The login name must be in SharePoint claims format (e.g., 'i:0#.f|membership|user@domain.com'). This action only registers the user in the site collection and does not grant any permissions. To assign list-level access, pass the returned Id field as principal_id to SHARE_POINT_ADD_ROLE_ASSIGNMENT_TO_LIST.

• follow write

  Follow SharePoint Actor

  Follow a SharePoint user, document, site, or tag. Use to make the authenticated user follow a specified actor. Supports following users (actor_type=0), documents (actor_type=1), sites (actor_type=2), or tags (actor_type=3).

• get_all_folders read

  Get All SharePoint Folders

  Tool to retrieve all folders in the SharePoint web. Use when you need to discover all available folders across the site. Supports OData query parameters for filtering, selecting specific fields, sorting, and pagination.

• get_changes read

  Get SharePoint List Changes

  Tool to retrieve changes from SharePoint list change log. Use when processing webhook notifications to get actual changes that occurred. Set boolean flags in query (Add, Item, Update, etc.) to filter change types. Store the ChangeToken from the last change and use as ChangeTokenStart in subsequent calls to track only new changes.

• get_content_type read

  Get Content Type

  Tool to retrieve a single SharePoint content type by its ID. Use when you need detailed information about a specific content type including its fields, forms, and metadata.

• get_content_types read

  Get Site Content Types

  Retrieves all content types from the current SharePoint site. Use this action to discover available content types on a SharePoint site. Returns metadata for each content type including Id, Name, Description, Group, and other properties. Supports OData query parameters for filtering, selecting specific fields, sorting, and pagination.

• get_content_types_for_list read

  Get Content Types for List

  Tool to retrieve all content types for a specific SharePoint list by GUID. Use when you need the content type IDs, names, and descriptions of every content type in a list.

• get_context_info read

  Get SharePoint Context Info

  Tool to retrieve SharePoint context information including the form digest value. Use when you need a form digest token for write operations (POST, PUT, DELETE).

• get_current_user read

  Get Current SharePoint User

  Tool to retrieve the current user for the site. Use after authenticating to get the current SharePoint user. A successful response confirms authentication only; access to specific sites, lists, or libraries depends on separate scopes and item-level permissions.

• get_drive_item_analytics read

  Get Drive Item Analytics

  Tool to get analytics for a SharePoint drive item. Use when you need to retrieve access statistics (view counts, unique viewers) for files or folders in SharePoint/OneDrive.

• get_group_users read

  Get Group Users

  Retrieves all users who are members of a specified SharePoint group. This action returns user information including IDs, names, email addresses, login names, and permission details. Supports OData query parameters for filtering, sorting, field selection, and pagination. Use this when you need to audit group membership, check user permissions, or list members of a specific group.

• get_group_users_by_id read

  Get Group Users By ID

  Tool to retrieve all users in a specific SharePoint site group by group ID. Use when you have the numeric group ID and need to list all members of that group, including their IDs, names, email addresses, and permission details. Supports OData query parameters for filtering, sorting, field selection, and pagination.

• get_item_attachment_content read

  Download List Item Attachment

  Tool to download an attachment from a SharePoint list item. Use when retrieving the binary contents of a specific attachment after confirming the list title, item ID, and filename.

• get_list_by_guid read

  Get SharePoint List by GUID

  Tool to retrieve a SharePoint list by its GUID. Use when you need to fetch list metadata by its unique identifier. Prefer over name-based lookup tools when the GUID is known, as names may collide across similarly named lists.

• get_list_by_title read

  Get SharePoint List By Title

  Tool to retrieve a SharePoint list by its title. Use when you need to fetch list metadata by title.

• get_list_content_type_by_id read

  Get Content Type by ID

  Tool to retrieve a specific content type from a SharePoint list by its ID. Use when you need detailed information about a particular content type including its fields, schema, and metadata.

• get_list_item_by_id read

  Get List Item by ID

  Tool to retrieve a SharePoint list item by ID. Use when you need to fetch a specific item after knowing its ID.

• get_list_items read

  Get SharePoint List Items

  Tool to retrieve items from a SharePoint list. Use when you need to fetch list entries with optional OData parameters.

• get_list_items_by_guid read

  Get SharePoint List Items by GUID

  Tool to retrieve items from a SharePoint list using its GUID. Use when you have the list's unique identifier and need to fetch list entries with optional OData parameters.

• get_list_item_version read

  Get List Item Version

  Tool to retrieve a specific version of a SharePoint list item. Use when you need to access historical versions of list items.

• get_my_followed read

  Get Followed Entities

  Tool to get entities the current user is following. Use when you need to retrieve followed users, documents, sites, or tags after authentication.

• get_my_followers read

  Get My Followers

  Retrieves the list of users who are following the authenticated user in SharePoint. Returns an array of SocialActor objects containing follower details like name, email, account name, and personal site URI. No parameters required - automatically retrieves followers for the current authenticated user.

• get_role_definitions read

  Get Role Definitions

  Tool to list role definitions at the web level. Role definition IDs and names are scoped per web/site collection — never hard-code them, as admins can modify role sets and IDs differ across site collections. Always resolve current values dynamically via this tool.

• get_site_by_hostname read

  Get SharePoint Site by Hostname

  Retrieve SharePoint site information by hostname or URL. Returns site metadata including site ID, display name, URLs, and timestamps. Use this action when you need to discover a site's identifier or properties using only its hostname, which is essential for subsequent operations requiring siteId. Useful for validating site existence or obtaining site metadata without prior knowledge of internal IDs.

• get_site_by_id read

  Get SharePoint Site by ID

  Tool to retrieve information about a SharePoint site (web) by its unique identifier. Use this action when you have a specific site GUID and need to fetch its metadata such as title, URL, language, or template information.

• get_site_collection_info read

  Get SharePoint Site Collection Info

  Tool to fetch site collection metadata (URL, ID, root web URI) only—not list item or document-level details. Use before subsequent calls to resolve correct API names. Requires SharePoint connection with site-collection-level scopes; may fail even when user-level tools succeed. Verify site_id before use—an incorrect site_id can silently return data for an unrelated site.

• get_site_drive_item_by_path read

  Get Site Drive Item by Path

  Tool to retrieve a file or folder by its server-relative path in a SharePoint site. Use when you need to get metadata for an item (file or folder) by path.

• get_site_page_content read

  Get SharePoint Site Page Content

  Tool to retrieve modern SharePoint Site Pages content by reading list item fields. Use when a .aspx page result cannot be downloaded as a file or when you need the structured content (CanvasContent1, LayoutWebpartsContent) of modern pages.

• get_site_root read

  Get SharePoint Root Site

  Retrieves metadata about the root web of a SharePoint site collection. Use this action when you need to get information about the root site in a site collection, such as its title, URL, language settings, or template information. This is useful for discovering the top-level site properties before navigating to subsites or performing collection-wide operations.

• get_user_effective_permissions_on_web read

  Get User Effective Permissions on Web

  Get a user's effective permissions on the current SharePoint site (Web). This action retrieves the combined permissions a user has on the site, taking into account direct permissions, group memberships, and permission inheritance. Use this when you need to verify what permissions a user or group has before performing operations. The response contains permission masks as 64-bit integers split into high and low 32-bit values. A value of "0" for both means no permissions. Returns site-level permissions only; list-level or item-level grants and restrictions are not reflected.

• get_webhook_subscription read

  Get SharePoint Webhook Subscription

  Tool to retrieve a specific webhook subscription by ID from a SharePoint list. Use when you need to check subscription details like expiration date or notification URL.

• get_webhook_subscriptions read

  Get SharePoint Webhook Subscriptions

  Tool to retrieve all webhook subscriptions on a SharePoint list. Use when you need to view existing webhook configurations for a list.

• get_web_info read

  Get SharePoint Web Info

  Tool to retrieve information about the current SharePoint web (site) using REST API. Use when you need web metadata such as title, URL, language, or template information.

• is_followed read

  Check Follow Status

  Tool to check if the current user is following a specified actor. Use when verifying follow status before performing follow or unfollow operations.

• list_all_lists read

  List SharePoint Lists

  Retrieves all lists in the current SharePoint web/site. Use this action to discover available lists and document libraries on a SharePoint site, or to pre-check for existing lists before creation (duplicate list names will fail). Returns metadata for each list including Title, Id, BaseType, ItemCount, and other properties. Supports OData query parameters for filtering, selecting specific fields, sorting, and pagination.

• list_drive_children read

  List Drive Children

  Tool to list children (files and folders) in a SharePoint drive using REST API v2.0. Use when you need to enumerate items in a drive's root folder or a specific folder within the drive.

• list_drive_recent_items read

  List Recently Modified Drive Items

  Tool to list recently modified items in a SharePoint drive using Microsoft Graph API. Returns files and folders from the root folder sorted by modification time (most recent first). Note: This action uses the /root/children endpoint with $orderby=lastModifiedDateTime desc to retrieve recently modified items from the root folder.

• list_drives_rest_api read

  List Drives via SharePoint REST API

  Tool to retrieve drives using SharePoint REST API v2.0. Use when you need to list document libraries and drives from a SharePoint site using native SharePoint authentication (not Microsoft Graph).

• list_files_in_folder read

  List Files in Folder

  Tool to list files within a SharePoint folder (non-recursive; does not enumerate subfolders). Use when you need to enumerate all files in a folder by its server-relative URL. To cover nested structures, call the tool separately for each subfolder.

• list_item_attachments read

  List Item Attachments

  Tool to list all attachments for a SharePoint list item. Use when you need to retrieve filenames and server-relative URLs of each attachment after confirming the list title and item ID.

• list_list_columns read

  List SharePoint List Columns

  Tool to list all column definitions in a SharePoint list. Use when you need to retrieve field metadata including column names, types, and properties.

• list_recycle_bin_items read

  List Recycle Bin Items

  Tool to list items in the SharePoint Recycle Bin. Use when you need to retrieve deleted items and page through results.

• list_site_drives read

  List Site Drives

  Tool to retrieve all document libraries (drives) in a SharePoint site. Use when you need to discover available document libraries or storage locations within a SharePoint site. This action lists all drives accessible in the specified site, including default document libraries and any custom document libraries created by users.

• list_site_groups read

  List Site Groups

  Tool to list SharePoint site groups for a site collection. Use when you need to see all groups and their settings before managing permissions.

• list_sites read

  List SharePoint Sites

  Tool to retrieve all SharePoint sites accessible to the user. Use when you need to discover available sites before performing site-specific operations.

• list_site_users read

  List Site Users

  Tool to list users in the site collection. Results include person users, groups, and system principals by default; use filter 'PrincipalType eq 1' to restrict to individual users.

• list_subfolders_in_folder read

  List Subfolders in Folder

  Tool to list immediate child folders within a SharePoint folder. Use when you need folder navigation or directory discovery by server-relative URL.

• log_event write

  Log SharePoint Event

  Log custom usage analytics events in SharePoint for tracking user activities. Records usage events (views, edits, custom actions) to SharePoint's analytics system. Use this after performing actions to track usage patterns. The event will be logged to SharePoint's usage analytics database for reporting and analytics purposes. Common use cases: - Track document views or edits - Record custom user interactions - Log application-specific events for analytics Note: Obtain site/web GUIDs from GET /api/site or GET /api/web endpoints. Use consistent item_id, scope_id, and site GUIDs across related events for the same entity to ensure correct analytics grouping and correlation in reports.

• recycle_file write

  Recycle SharePoint File

  Tool to move a file to the Recycle Bin. Use when you need to recycle a file after confirming its folder and filename paths.

• recycle_list_item write

  Recycle SharePoint List Item

  Tool to move a list item to the Recycle Bin. Use when you need to soft-delete an item but preserve the ability to restore it.

• rename_folder write

  Rename SharePoint Folder

  Renames a SharePoint folder by updating its list item metadata. To use this action: 1. Provide the folder path and new leaf folder name. 2. The action updates the folder list item fields needed by SharePoint. The rename operation updates both the folder's display name (Title) and actual name (FileLeafRef). Note: This only changes the folder name, not its location in the hierarchy.

• render_list_data_as_stream read

  Render List Data As Stream

  Retrieve list items from SharePoint with rich metadata and formatting. Returns items in the 'Row' array along with pagination info (FirstRow, LastRow, NextHref). Supports CAML queries via ViewXml for filtering and sorting. Use this when you need list data with properly formatted field values, lookup fields, or managed metadata - more capable than standard OData endpoints.

• restore_drive_item_version write

  Restore Drive Item Version

  Tool to restore a previous version of a SharePoint drive item. Use when you need to revert a file to an earlier version.

• restore_recycle_bin_item write

  Restore Recycle Bin Item

  Tool to restore a SharePoint Recycle Bin item. Use when you need to recover a deleted item by providing its GUID.

• search_files read

  Search Files Across All Sites

  Search for files across all SharePoint sites and OneDrive using Keyword Query Language. Returns files matching the query with metadata like title, path, size, author, and modification time. Use this action when you need to discover files broadly across an organization without knowing specific drive IDs or site locations. Results are automatically filtered to show only document content types. Use from_index and row_limit parameters to paginate through large result sets.

• search_query read

  Search SharePoint Site

  Search SharePoint content using Keyword Query Language (KQL). Returns documents, list items, folders, and other content matching your query. Supports filtering by properties (file type, author, date), pagination, and custom property selection. Results are nested under PrimaryQueryResult→RelevantResults→Table→Rows→Cells as Key/Value pairs requiring explicit extraction. Results are security-trimmed: inaccessible content never appears even if it exists. Use contentclass (e.g., STS_Site, STS_Web, STS_ListItem_DocumentLibrary) in querytext to isolate specific item types.

• search_suggest read

  Search Suggest

  Tool to get search query suggestions. Use when you need to provide autocomplete options for user search input.

• sharepoint_check_out_file write

  Check Out SharePoint File

  Tool to check out a file in a document library. Use when you need to lock a file before making changes.

• sharepoint_create_folder write

  Create SharePoint Folder

  Creates a new folder in SharePoint using the REST API. Returns `server_relative_url`; use it for downstream operations instead of constructing paths manually. Does not configure sharing or permissions on the created folder.

• sharepoint_create_list write

  Create SharePoint List

  Creates a new list in SharePoint using the REST API. Custom columns cannot be added at creation time; use SHARE_POINT_CREATE_LIST_FIELD with the returned `list_id` to add them afterward. Check `success` and `error` fields in the response to confirm creation. Returns a `list_id` used by downstream tools; note SHARE_POINT_SHAREPOINT_CREATE_LIST_ITEM targets lists by `list_name` (title).

• sharepoint_create_list_item write

  Create SharePoint List Item

  Creates a new item in a SharePoint list. Returns an `item_data` object containing `item_id`, `Title`, and timestamps on success.

• sharepoint_find_user read

  Find SharePoint User

  Searches for a user in the SharePoint site by email address and returns their profile information if found. Response includes `exists_in_graph`, `exists_in_sharepoint`, and `error_details` fields; inspect all three together — `successful=true` can coexist with Graph errors in `error_details`. When the two backends diverge, treat `exists_in_sharepoint` as authoritative for access decisions.

• sharepoint_remove_user write

  Remove SharePoint User

  Removes a user from SharePoint. Returns success even if user doesn't exist or was never a member; check response fields `was_removed` (bool) and `message` (str) to distinguish an actual removal from a no-op.

• undo_checkout_file write

  Undo SharePoint File Checkout

  Tool to undo a file checkout, discarding any changes made while checked out. Use when you need to cancel edits and unlock the file without saving.

• update_content_type write

  Update SharePoint Content Type

  Tool to update a SharePoint content type's properties such as name, description, group, or hidden status. Use when you need to modify content type metadata.

• update_drive_item write

  Update Drive Item

  Tool to update the properties of a drive item (file or folder) in SharePoint using SharePoint REST API. Use when you need to rename files/folders or update their title property.

• update_file_item write

  Update File Item Metadata

  Tool to update metadata fields on a SharePoint file item via its ListItemAllFields. Use this action when you need to modify document properties, custom columns, or metadata without changing the file content itself. This operates on the list item behind the file, allowing you to set Title, Status, Owner, Categories, or any other library column.

• update_list write

  Update SharePoint List

  Tool to update properties of an existing SharePoint list. Use when you need to modify list metadata such as title, description, or settings like versioning and attachments.

• update_list_item write

  Update SharePoint List Item

  Tool to update fields on an existing SharePoint list item. Use when you need to modify an item's properties with proper ETag concurrency control via MERGE.

• update_site write

  Update SharePoint Site

  Tool to update properties of the current SharePoint site (web). Use when you need to modify site title, description, or other SP.Web properties via MERGE.

• upload_file write

  Upload File to Folder

  Tool to upload a file to a SharePoint document library or folder. Use when you need to programmatically add or update a file in a document library.

• upload_from_url write

  Upload File from URL to SharePoint

  Tool to fetch a file from a URL and upload it to SharePoint. Use when you need to upload files directly from external URLs without downloading them to the client first. When a file with the same name already exists, use conflict_behavior to control the behavior: - 'replace': Overwrites the existing file (fails with HTTP 423 if the file is locked/open) - 'fail': Returns an error if a file with that name exists - 'rename': Uploads with an auto-generated suffix (e.g., 'report 1.docx'), bypassing file locks

• validate_credential read

  Validate SharePoint Credentials

  Validate SharePoint credentials by attempting to retrieve the current user information. Use this action during setup or configuration to verify that provided credentials have valid access to the SharePoint site before performing other operations.

No tools match your search.