Clearly AIDocs

SharePoint

Connect Clearly AI to SharePoint to read documents into Projects and write generated documents back via Workflows.

Overview

The SharePoint integration lets Clearly AI:

  • Read SharePoint sites, document libraries, and files into a Project as context for Reviews and Chat.
  • Search the contents of those files when answering questions.
  • Write generated documents back to SharePoint from a Workflow (for example, a finalized review summary or assessment report).

Authentication uses Microsoft OAuth 2.0 against Microsoft Entra ID. Credentials can be scoped to a single user or shared across the organization.


Prerequisites

  • Access to Integrations in Organization settings.
  • A Microsoft 365 work account with access to the SharePoint sites you want to connect. Personal Microsoft accounts (outlook.com, hotmail.com, live.com) are not supported by the SharePoint APIs Clearly AI uses.
  • Pop-ups allowed for the Clearly AI domain in your browser. The Microsoft consent screen opens in a new window.

Permissions Microsoft will request

When you authorize Clearly AI, Microsoft will display a consent screen requesting these scopes:

ScopeWhy Clearly AI needs it
User.ReadIdentify the connecting user.
Sites.ReadWrite.AllList sites and document libraries; create files when a Workflow writes a document.
Files.ReadWrite.AllRead file content for Project context; write files generated by Workflows.
openid, offline_accessSign in and keep the connection refreshed without re-prompting.

Write permissions are required because of the Write SharePoint Doc workflow node (see Writing documents back to SharePoint). If your organization does not use that capability, the integration will only ever read.


Connect SharePoint

Open the SharePoint integration

In Clearly AI, open Organization settings, select Integrations, then click Set up on the SharePoint card.

Authorize Clearly AI

Check I understand under the shared-credential notice, then click Connect. A new window opens to Microsoft's sign-in and consent screen. Sign in with your Microsoft 365 work account and approve the requested permissions.

Add the credential

Click Add workspace credential. Clearly AI makes a test call to Microsoft Graph to check that the token is valid and the SharePoint permissions were granted. It enables the integration only when the test passes. If the test fails, fix the cause and try again. See FAQs for specific error messages.

To connect your own SharePoint account instead, open Customize, go to the Yours tab, and click Connect on SharePoint. SharePoint appears there only after an admin installs its Connector. When a Source runs as you, it uses your Personal Connection. If you have both a Personal and a Workspace Connection, your Personal Connection takes precedence for Sources. Workflow steps use the Connection selected on the step.


Use SharePoint in a Project

Once SharePoint is connected, you can attach SharePoint content to any Project as an integration source.

  1. Open a Project and add a new integration source. Select SharePoint.
  2. Paste either:
    • A SharePoint site URL, e.g. https://contoso.sharepoint.com/sites/security, or
    • A shared link to a folder, e.g. a "Copy link" URL from SharePoint or OneDrive.
  3. Clearly AI will discover the files inside the site or shared folder, including files in nested folders, and present them as a checklist.
  4. Use Select All, Clear, or check individual files to choose which ones to include in the Project.
  5. Save the integration source. The selected files become part of the Project's context for Reviews, Chat, and Workflows.

Files are fetched on demand and converted to a text/markdown representation so the LLM can reason over them. Folder structure is walked recursively.

Supported file types

Native text formatsOffice and document formats (converted to PDF by Microsoft Graph)
Plain text (text/*), JSON, XML, JavaScript, YAML, SQLWord: .doc, .docx, .dot, .dotx, .dotm
PowerPoint: .ppt, .pptx, .pps, .ppsx
Excel: .xls, .xlsx, .xlsm
OpenDocument: .odt, .ods, .odp
Other: .rtf, .eml, .msg, .epub, .tif, .tiff

SharePoint pages (.aspx) are also supported: their canvas content is extracted as markdown.

PDFs are read directly. Files in formats not listed above are skipped with an error reported on the file.


Writing documents back to SharePoint

The Write SharePoint Doc Workflow node creates a new markdown file in SharePoint using LLM-generated content. Configure it with:

  • Parent web URL – a SharePoint site URL under /sites/<site-name>/....
  • Folder path (optional) – relative folder path inside the site.
  • Create folder if missing – auto-create any missing folders in the path.
  • Document title – file name. If you omit an extension, .md is appended.
  • Document content instructions – a prompt describing what the document should contain. The Workflow's accumulated context is passed to the LLM along with these instructions.

The node writes the file and emits its SharePoint URL as an artifact that downstream nodes can reference.


FAQs


  • Concepts – How Integrations fit into Projects, Reviews, and Workflows.