SharePoint

Let your agents find your SharePoint sites, read lists and list items, browse and search document libraries, add and update list items and create folders on your behalf.

Connection

Authentication: OAuth 2.0 — you authorize Atako via SharePoint’s consent screen; no key to copy.
Scopes requested:
- offline_access
- User.Read
- Sites.Read.All
- Sites.ReadWrite.All

Nothing to paste: click Connect and sign in with your Microsoft 365 work or school account. Prerequisite on the Atako side — same Microsoft Entra app as Outlook, Teams and OneDrive: an administrator sets INTEGRATION_OAUTH_SHAREPOINT_CLIENT_ID / _CLIENT_SECRET to the same values as INTEGRATION_OAUTH_OUTLOOK_CLIENT_ID / _CLIENT_SECRET, and adds the delegated permissions in Entra → App registrations → Atako → API permissions → Microsoft Graph → Delegated: User.Read, Sites.Read.All, Sites.ReadWrite.All, offline_access. Sites.ReadWrite.All often requires an administrator of your Microsoft 365 tenant to grant consent (tenants that restrict user consent).See SharePoint’s documentation.

Read actions (13)

Action	Description
`get_item_by_path`	Fetch a file or folder of a document library by its path from the library root, e.g. “Contracts/2026/Offer Acme.docx”. Returns id, name, size, file/folder facet, webUrl.
`get_list`	Fetch a list by id or display title. expand_columns: true also returns its column definitions (internal names and types) — read it before create_list_item / update_list_item_fields.
`get_list_item`	Fetch one list item with its column values (fields), created/modified dates and authors.
`get_site`	Fetch a site (id, name, displayName, description, webUrl). Pass site_id “root” for the tenant root site — the quickest check that the connection works.
`get_site_by_path`	Fetch a site from its URL: hostname “contoso.sharepoint.com” and server-relative path “sites/Marketing” for https://contoso.sharepoint.com/sites/Marketing. Returns the site id used by the other actions.
`list_drive_children`	List files and folders inside a folder of a document library. item_id “root” lists the library top level. Optional: top (1–200), orderby (“name” or “lastModifiedDateTime desc”).
`list_drives`	List the document libraries (drives) of a site — id, name (e.g. “Documents”), webUrl. The drive id is used by the file actions. Optional: top (1–200).
`list_list_items`	List the items of a list with their column values (fields). Optional: select (column internal names to return), filter (OData, e.g. “fields/Status eq ‘Open’” — operators eq, ne, lt, gt, le, ge, startswith; works best on indexed columns), top (1–500).
`list_lists`	List the lists and document libraries of a site (id, name, displayName, list.template — “genericList”, “documentLibrary”…, webUrl).
`list_pages`	List the modern pages of a site (id, name, title, webUrl, pageLayout, publishingState, lastModifiedDateTime) — metadata only, not the page content. Optional: top (1–200).
`list_subsites`	List the subsites of a site (id, name, displayName, webUrl).
`search_drive_items`	Search a document library for files and folders matching a query (file names, metadata and file content). Optional: top (1–200).
`search_sites`	Search the SharePoint sites the connected user can access by keyword (site name, title, description). Returns id, name, displayName, webUrl for each site.

Write actions (3)

Action	Description
`create_folder`	Create a folder in a document library. parent_id “root” creates it at the library top level. conflictBehavior: “rename” (default, auto-rename), “replace” (overwrite) or “fail” (error if the name exists).
`create_list_item`	Add an item to a list. fields maps column INTERNAL names to values, e.g. {“Title”: “Widget”, “Color”: “Purple”, “Weight”: 32} — check the columns with get_list (expand_columns: true) first. Returns the created item id.
`update_list_item_fields`	Update column values of an existing list item: only the columns given in fields change, e.g. {“Status”: “Done”, “Quantity”: 934}. Returns the updated column values.

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (13)

Write actions (3)

Permissions

​Connection

​Read actions (13)

​Write actions (3)

​Permissions

Connection

Read actions (13)

Write actions (3)

Permissions