ComposioHQ/SharePoint-Automation

Automação do SharePoint

Automatize operações do SharePoint, incluindo gerenciamento de sites, listas, documentos, pastas e páginas. Integra-se com a API REST do SharePoint e o Microsoft Graph via OneDrive.

Documentação do toolkit: composio.dev/toolkits/share_point

---

Configuração

Esta skill requer o servidor MCP Rube conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, garanta que existam conexões ativas para os toolkits share_point e one_drive. Se nenhuma conexão estiver ativa, inicie uma via RUBE_MANAGE_CONNECTIONS.

Nota: Muitas ferramentas do OneDrive/SharePoint funcionam apenas com contas organizacionais Microsoft 365 (Azure AD/Entra ID). Contas pessoais da Microsoft NÃO são suportadas.

---

Fluxos de Trabalho Principais

1. Listar e Navegar por Sites

Obtenha detalhes de sites e enumere subsites para descobrir a topologia do SharePoint.

Ferramentas:

• ONE_DRIVE_GET_SITE_DETAILS -- Obtém metadados de um site específico por ID
• ONE_DRIVE_LIST_SITE_SUBSITES -- Lista todos os subsites de um site pai

Parâmetros Principais:

• site_id (obrigatório) -- Formato composto: hostname,site-collection-guid,web-guid (ex.: "contoso.sharepoint.com,da60e844-...,712a596e-...")

Exemplo:

Ferramenta: ONE_DRIVE_GET_SITE_DETAILS
Argumentos:
  site_id: "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"

---

2. Gerenciar Listas

Crie listas, enumere listas existentes e recupere itens de lista.

Ferramentas:

• SHARE_POINT_LIST_ALL_LISTS -- Recupera todas as listas de um site (suporta filtro OData, select, orderby, top)
• SHARE_POINT_SHAREPOINT_CREATE_LIST -- Cria uma nova lista com um template especificado
• ONE_DRIVE_LIST_SITE_LISTS -- Lista todas as listas de um site via Microsoft Graph
• ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS -- Recupera itens de uma lista específica

Parâmetros Principais para SHARE_POINT_SHAREPOINT_CREATE_LIST:

• name (obrigatório) -- Nome da lista
• template (obrigatório) -- Tipo de template: "genericList", "documentLibrary", "tasks", etc.
• description -- Descrição opcional

Parâmetros Principais para SHARE_POINT_LIST_ALL_LISTS:

• filter -- Filtro OData, ex.: "Hidden eq false"
• select -- Propriedades a retornar, ex.: "Title,Id"
• orderby -- Expressão de ordenação, ex.: "Title desc"
• top -- Limite de resultados

Exemplo:

Ferramenta: SHARE_POINT_SHAREPOINT_CREATE_LIST
Argumentos:
  name: "Tarefas do Projeto"
  template: "tasks"
  description: "Acompanhamento de tarefas para entregas do Q1"

---

3. Gerenciar Pastas e Arquivos

Crie pastas, liste arquivos dentro de pastas e navegue pela biblioteca de documentos.

Ferramentas:

• SHARE_POINT_SHAREPOINT_CREATE_FOLDER -- Cria uma nova pasta em uma biblioteca de documentos
• SHARE_POINT_LIST_FILES_IN_FOLDER -- Lista arquivos dentro de uma pasta pela URL relativa ao servidor
• SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL -- Obtém metadados da pasta pelo caminho

Parâmetros Principais para SHARE_POINT_SHAREPOINT_CREATE_FOLDER:

• folder_name (obrigatório) -- Nome da pasta a criar
• document_library -- Biblioteca alvo (padrão: "Shared Documents")
• relative_path -- Caminho adicional dentro da biblioteca

Parâmetros Principais para SHARE_POINT_LIST_FILES_IN_FOLDER:

• folder_name (obrigatório) -- URL relativa ao servidor, ex.: "/Shared Documents"
• select -- Propriedades separadas por vírgula, ex.: "Name,ServerRelativeUrl,Length"
• top -- Limite de resultados
• orderby -- Expressão de ordenação, ex.: "Name desc"

Exemplo:

Ferramenta: SHARE_POINT_LIST_FILES_IN_FOLDER
Argumentos:
  folder_name: "/Shared Documents/Reports"
  select: "Name,ServerRelativeUrl,Length"
  top: 50

---

4. Pesquisar Conteúdo do SharePoint

Use a Linguagem de Consulta por Palavras-chave (KQL) para pesquisar documentos, itens de lista e outros conteúdos no site.

Ferramenta: SHARE_POINT_SEARCH_QUERY

Parâmetros Principais:

• querytext (obrigatório) -- Consulta KQL, ex.: "relatório do projeto", "FileType:docx", "Author:\"João Silva\""
• rowlimit -- Máximo de resultados por requisição (padrão ~50, máximo 500)
• startrow -- Deslocamento base zero para paginação
• selectproperties -- Propriedades a retornar, ex.: "Title,Author,Path"
• refinementfilters -- Filtros de refinamento, ex.: "FileType:equals(\"docx\")"

Exemplo:

Ferramenta: SHARE_POINT_SEARCH_QUERY
Argumentos:
  querytext: "IsDocument:1 FileType:pdf"
  rowlimit: 25
  selectproperties: "Title,Author,Path,LastModifiedTime"

---

5. Rastrear Alterações em Listas (Consulta Delta)

Use consultas delta para obter alterações incrementais (itens criados, atualizados, excluídos) sem ler a lista inteira.

Ferramenta: ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA

Parâmetros Principais:

• site_id (obrigatório) -- ID composto do site
• list_id (obrigatório) -- GUID da lista
• token -- Omita para sincronização inicial; passe "latest" para resposta vazia com token; passe token anterior para alterações desde então
• expand -- ex.: "fields($select=ColunaA,ColunaB)"
• top -- Máximo de itens por resposta

---

6. Recuperar Conteúdo de Página do Site

Leia conteúdo de Páginas de Site modernas do SharePoint, incluindo web parts do canvas.

Ferramenta: SHARE_POINT_GET_SITE_PAGE_CONTENT

Parâmetros Principais:

• page_file_name -- Nome do arquivo com extensão .aspx, ex.: "Home.aspx"
• item_id -- Alternativa: ID do item de lista da página
• render_as -- "raw" (padrão), "text" ou "html"
• site -- Escopo opcional do nome do site

---

Armadilhas Conhecidas

Armadilha	Detalhe
Formato do ID do site	Deve ser composto: hostname,site-collection-guid,web-guid. Formato incorreto causa erros 400.
Contas pessoais não suportadas	ONE_DRIVE_LIST_SITE_LISTS e ferramentas baseadas no Graph funcionam apenas com contas organizacionais M365, não com contas pessoais MSA/Outlook.com.
Sintaxe de filtro OData	Filtros OData do SharePoint usam sintaxe específica. Teste filtros incrementalmente; expressões não suportadas podem retornar silenciosamente resultados vazios.
Paginação	Use skiptoken para paginação no lado do servidor em operações de lista. Configurações incompletas de paginação podem perder resultados.
Caminhos de pastas	Devem usar URLs relativas ao servidor (ex.: /Shared Documents), não URLs absolutas.

---

Referência Rápida

Slug da Ferramenta	Descrição
ONE_DRIVE_GET_SITE_DETAILS	Obtém metadados de um site do SharePoint
ONE_DRIVE_LIST_SITE_SUBSITES	Lista subsites de um site pai
ONE_DRIVE_LIST_SITE_LISTS	Lista todas as listas de um site (Graph API)
ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA	Rastreia alterações incrementais em listas
ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS	Recupera itens de uma lista
ONE_DRIVE_LIST_DRIVES	Lista unidades disponíveis para um usuário/site/grupo
ONE_DRIVE_LIST_SITE_COLUMNS	Lista definições de colunas de um site
SHARE_POINT_LIST_ALL_LISTS	Recupera todas as listas de um site (REST API)
SHARE_POINT_SHAREPOINT_CREATE_LIST	Cria uma nova lista do SharePoint
SHARE_POINT_SHAREPOINT_CREATE_FOLDER	Cria uma pasta em uma biblioteca de documentos
SHARE_POINT_LIST_FILES_IN_FOLDER	Lista arquivos em uma pasta
SHARE_POINT_SEARCH_QUERY	Pesquisa conteúdo usando KQL
SHARE_POINT_GET_SITE_PAGE_CONTENT	Recupera conteúdo de Página de Site
SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL	Obtém metadados da pasta pelo caminho

---

Desenvolvido por Composio