Skip to main content
SharePoint Logo

SharePoint Toolset

SharePoint sites, files, pages, and OneNote

ReadyMicrosoft 365

Overview

The SharePoint toolset enables AI agents to interact with your SharePoint Online content via the Microsoft Graph API. Agents can browse sites, read and update pages, search and manage files across drives, and create or read OneNote notebooks.

Key Capabilities

  • Sites — list and inspect SharePoint sites the user has access to
  • Pages — read, search, create, and update SharePoint site pages
  • Files & drives — list drives and files, search across content, read file metadata and content, create folders and Word documents, move items
  • OneNote — find notebooks, list pages, read content, and create new notebooks

Available Tools

Sites

Pages

Files & Drives

OneNote


Configuration Guide

Step 1: Open App registrations from the Azure portal home

  1. Go to portal.azure.com and sign in.
  2. On the home page, find Azure services and click App registrations (grid icon). You can also search the top bar for App registrations or open Microsoft Entra ID and choose App registrations from there.
Azure portal home with App registrations

Step 2: Start a new registration

On the App registrations page, click + New registration.
App registrations list with New registration

Step 3: Register the application

  1. Name: Enter a display name (for example, PipesHub SharePoint Toolset).
  2. Supported account types: Choose who can sign in — for example Accounts in any organizational directory and personal Microsoft accounts for the broadest support, or a single-tenant option if you only use your organization.
  3. Redirect URI: Get the Redirect URI from the PipesHub Configure SharePoint dialog in Workspace Settings → Actions (where SharePoint is set up — for example + Setup / Configure). Set the platform to Web and paste the value.
PipesHub Configure SharePoint dialog showing Redirect URI
  1. Click Register.

Step 4: Copy Application (client) ID and Directory (tenant) ID

On the Overview page for your app, copy:
  • Application (client) ID — used as Client ID in PipesHub.
  • Directory (tenant) ID — used as Tenant ID in PipesHub.
App registration Overview with client and tenant IDs
Use the Application (client) ID, not the Object ID. They are different values.

Step 5: Create a client secret

  1. In the left sidebar under Manage, open Certificates & secrets.
  2. On the Client secrets tab, click + New client secret.
  3. Add a description, choose an expiration, then click Add.
  4. Copy the secret value immediately — it is shown only once.
Certificates and secrets with new client secret
If you leave this page without copying the secret, you cannot read it again — create a new client secret instead.

Step 6: Add Microsoft Graph API permissions

  1. In the left sidebar, open API permissions.
  2. Click + Add a permissionMicrosoft GraphDelegated permissions.
  3. Add the following permissions:
Add Microsoft Graph delegated permissions for SharePoint
The SharePoint toolset uses Delegated permissions so actions run as the signed-in user, not as the app alone.
The *.All scopes (e.g., Sites.ReadWrite.All) require admin consent at the tenant level even for delegated flows. Click Grant admin consent for your organization (the button includes your tenant name) and confirm. All permissions should show a green check after consent is granted.
API permissions with Grant admin consent

Step 8: Configure the SharePoint toolset in PipesHub

  1. In PipesHub, go to Workspace SettingsActions.
  2. Find SharePoint and open setup / configuration (+ Setup or Configure).
  3. Confirm the Redirect URI in the dialog matches the Web redirect URI you registered in Azure in Step 3.
  4. Enter Client ID, Client Secret, and Tenant ID, then create or save the instance.
Workspace Actions SharePoint toolset configuration

Step 9: Authenticate the SharePoint toolset

Authentication uses the same OAuth flow in either location:
  • Admins can authenticate the shared instance directly under Workspace Settings → Actions.
  • Users can authenticate their own personal instance under Your actions (in the Personal section of the sidebar).
  1. On the SharePoint tile (in Actions or Your actions), click Authenticate with OAuth.
  2. A popup opens to Microsoft’s sign-in page — sign in and accept the permissions.
  3. The popup closes and the SharePoint tile shows Authenticated status.
Microsoft OAuth consent popup — sign in and accept permissions

Step 10: Add SharePoint to an agent

  1. Go to the Home page.
  2. Next to Agents, click + to create a new agent.
  3. Give the agent a name, drag the SharePoint toolset onto the canvas, connect it to the Agent Core node with your model and chat input/output, then create the agent.
Agent builder with SharePoint toolset connected

FAQ

Example: Use the SharePoint Connector to search across all your indexed SharePoint content. Use the SharePoint Toolset to let agents create pages, upload files, or manage OneNote notebooks on behalf of the signed-in user.

Usage Tips

List the SharePoint sites I can access
Ask your agent to “list my SharePoint sites” or “what SharePoint sites am I a member of?”
Search for a file across drives
Ask to “search SharePoint for the Q4 budget spreadsheet” — the agent searches across drives the user has access to.
Create a new page
Ask to “create a new SharePoint page in the Engineering site titled ‘Release Notes’ with content X”. The agent creates the page and returns its URL.
Read or update a page
Ask to “show me the content of the Onboarding page in the HR site” or “update the Release Notes page to add today’s deploy summary”.
Create a OneNote notebook
Ask to “create a new OneNote notebook called Sprint Planning in my OneNote” — the agent creates it and returns the notebook ID.