SharePoint Automation
サイト、リスト、ドキュメント、フォルダ、ページの管理など、SharePoint操作を自動化します。SharePoint REST APIおよびMicrosoft Graph（OneDrive経由）の両方と統合します。
ツールキットドキュメント: composio.dev/toolkits/share_point
セットアップ
このスキルを使用するには、https://rube.app/mcp に接続された Rube MCPサーバー が必要です。
ツールを実行する前に、share_point および one_drive ツールキットのアクティブな接続が存在することを確認してください。アクティブな接続がない場合は、RUBE_MANAGE_CONNECTIONS を使用して接続を開始してください。
注: 多くのOneDrive/SharePointツールは、組織のMicrosoft 365アカウント（Azure AD/Entra ID）でのみ動作します。個人のMicrosoftアカウントはサポートされていません。
コアワークフロー
1. サイトの一覧表示と閲覧
サイトの詳細を取得し、サブサイトを列挙してSharePointトポロジを探索します。
ツール:
ONE_DRIVE_GET_SITE_DETAILS-- 特定のサイトのメタデータをIDで取得ONE_DRIVE_LIST_SITE_SUBSITES-- 親サイトのすべてのサブサイトを一覧表示
主要パラメータ:
site_id(必須) -- 複合形式:hostname,site-collection-guid,web-guid(例:"contoso.sharepoint.com,da60e844-...,712a596e-...")
例:
Tool: ONE_DRIVE_GET_SITE_DETAILS
Arguments:
site_id: "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE"
2. リストの管理
リストを作成し、既存のリストを列挙し、リストアイテムを取得します。
ツール:
SHARE_POINT_LIST_ALL_LISTS-- サイト上のすべてのリストを取得（ODataフィルター、select、orderby、topをサポート）SHARE_POINT_SHAREPOINT_CREATE_LIST-- 指定されたテンプレートで新しいリストを作成ONE_DRIVE_LIST_SITE_LISTS-- Microsoft Graphを介してサイト下のすべてのリストを一覧表示ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS-- 特定のリストからアイテムを取得
SHARE_POINT_SHAREPOINT_CREATE_LIST の主要パラメータ:
name(必須) -- リスト名template(必須) -- テンプレートタイプ:"genericList"、"documentLibrary"、"tasks"などdescription-- オプションの説明
SHARE_POINT_LIST_ALL_LISTS の主要パラメータ:
filter-- ODataフィルター、例:"Hidden eq false"select-- 返すプロパティ、例:"Title,Id"orderby-- ソート式、例:"Title desc"top-- 結果数の制限
例:
Tool: SHARE_POINT_SHAREPOINT_CREATE_LIST
Arguments:
name: "Project Tasks"
template: "tasks"
description: "Q1納品物のタスク追跡"
3. フォルダとファイルの管理
フォルダを作成し、フォルダ内のファイルを一覧表示し、ドキュメントライブラリ内をナビゲートします。
ツール:
SHARE_POINT_SHAREPOINT_CREATE_FOLDER-- ドキュメントライブラリに新しいフォルダを作成SHARE_POINT_LIST_FILES_IN_FOLDER-- サーバー相対URLを使用してフォルダ内のファイルを一覧表示SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL-- パス指定でフォルダのメタデータを取得
SHARE_POINT_SHAREPOINT_CREATE_FOLDER の主要パラメータ:
folder_name(必須) -- 作成するフォルダ名document_library-- 対象ライブラリ（デフォルト:"Shared Documents"）relative_path-- ライブラリ内の追加パス
SHARE_POINT_LIST_FILES_IN_FOLDER の主要パラメータ:
folder_name(必須) -- サーバー相対URL、例:"/Shared Documents"select-- カンマ区切りのプロパティ、例:"Name,ServerRelativeUrl,Length"top-- 結果数の制限orderby-- ソート式、例:"Name desc"
例:
Tool: SHARE_POINT_LIST_FILES_IN_FOLDER
Arguments:
folder_name: "/Shared Documents/Reports"
select: "Name,ServerRelativeUrl,Length"
top: 50
4. SharePointコンテンツの検索
キーワードクエリ言語（KQL）を使用して、サイト全体のドキュメント、リストアイテム、その他のコンテンツを検索します。
ツール: SHARE_POINT_SEARCH_QUERY
主要パラメータ:
querytext(必須) -- KQLクエリ、例:"project report"、"FileType:docx"、"Author:\"John Doe\""rowlimit-- リクエストあたりの最大結果数（デフォルト約50、最大500）startrow-- ページネーション用のゼロベースのオフセットselectproperties-- 返すプロパティ、例:"Title,Author,Path"refinementfilters-- 結果を絞り込む、例:"FileType:equals(\"docx\")"
例:
Tool: SHARE_POINT_SEARCH_QUERY
Arguments:
querytext: "IsDocument:1 FileType:pdf"
rowlimit: 25
selectproperties: "Title,Author,Path,LastModifiedTime"
5. リスト変更の追跡（デルタクエリ）
デルタクエリを使用して、リスト全体を読み込まずに増分変更（作成、更新、削除されたアイテム）を取得します。
ツール: ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA
主要パラメータ:
site_id(必須) -- 複合サイトIDlist_id(必須) -- リストGUIDtoken-- 初期同期では省略。空の応答とトークンを取得するには"latest"を渡す。以前のトークンを渡すとそれ以降の変更を取得。expand-- 例:"fields($select=ColumnA,ColumnB)"top-- 応答あたりの最大アイテム数
6. サイトページコンテンツの取得
キャンバスWebパーツを含むモダンSharePointサイトページのコンテンツを読み取ります。
ツール: SHARE_POINT_GET_SITE_PAGE_CONTENT
主要パラメータ:
page_file_name--.aspx拡張子を含むファイル名、例:"Home.aspx"item_id-- 代替: ページのリストアイテムIDrender_as--"raw"（デフォルト）、"text"、または"html"site-- オプションのサイト名スコープ
既知の落とし穴
| 落とし穴 | 詳細 |
|---|---|
| サイトIDの形式 | hostname,site-collection-guid,web-guid の複合形式である必要があります。形式が正しくないと400エラーが発生します。 |
| 個人アカウントは非対応 | ONE_DRIVE_LIST_SITE_LISTS およびGraphベースのツールは、組織のM365アカウントでのみ動作し、個人のMSA/Outlook.comアカウントでは動作しません。 |
| ODataフィルター構文 | SharePointのODataフィルターは特定の構文を使用します。フィルターは段階的にテストしてください。サポートされていない式は、エラーなく空の結果を返す場合があります。 |
| ページネーション | リスト操作のサーバー側ページネーションには skiptoken を使用してください。不完全なページネーション設定は結果を見逃す可能性があります。 |
| フォルダパス | 絶対URLではなく、サーバー相対URL（例: /Shared Documents）を使用する必要があります。 |
クイックリファレンス
| ツールスラッグ | 説明 |
|---|---|
ONE_DRIVE_GET_SITE_DETAILS | SharePointサイトのメタデータを取得 |
ONE_DRIVE_LIST_SITE_SUBSITES | 親サイトのサブサイトを一覧表示 |
ONE_DRIVE_LIST_SITE_LISTS | サイト下のすべてのリストを一覧表示（Graph API） |
ONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTA | リストの増分変更を追跡 |
ONE_DRIVE_GET_SHAREPOINT_LIST_ITEMS | リストからアイテムを取得 |
ONE_DRIVE_LIST_DRIVES | ユーザー/サイト/グループの利用可能なドライブを一覧表示 |
ONE_DRIVE_LIST_SITE_COLUMNS | サイトの列定義を一覧表示 |
SHARE_POINT_LIST_ALL_LISTS | サイト上のすべてのリストを取得（REST API） |
SHARE_POINT_SHAREPOINT_CREATE_LIST | 新しいSharePointリストを作成 |
SHARE_POINT_SHAREPOINT_CREATE_FOLDER | ドキュメントライブラリにフォルダを作成 |
SHARE_POINT_LIST_FILES_IN_FOLDER | フォルダ内のファイルを一覧表示 |
SHARE_POINT_SEARCH_QUERY | KQLを使用してコンテンツを検索 |
SHARE_POINT_GET_SITE_PAGE_CONTENT | サイトページのコンテンツを取得 |
SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL | パス指定でフォルダのメタデータを取得 |
Powered by Composio