// How to upload, download, and manage files in SharePoint document libraries and OneDrive via the Microsoft Graph CLI (mgc). Use this skill whenever the user wants to upload files to SharePoint, download files, list folder contents, or navigate SharePoint drive structures.
| name | msgraph-files |
| description | How to upload, download, and manage files in SharePoint document libraries and OneDrive via the Microsoft Graph CLI (mgc). Use this skill whenever the user wants to upload files to SharePoint, download files, list folder contents, or navigate SharePoint drive structures. |
./mgc-cli/mgc
SharePoint drive access requires Sites.ReadWrite.All. Without it, drive endpoints return 403 accessDenied.
./mgc-cli/mgc login --scopes Sites.ReadWrite.All --strategy InteractiveBrowser
https://tenant.sharepoint.com/backofficeShared Documents).drive-item-id./mgc-cli/mgc sites get --site-id "tenant.sharepoint.com:/site-relative-path"
# e.g.
./mgc-cli/mgc sites get --site-id "softwarearchitects1com.sharepoint.com:/backoffice"
./mgc-cli/mgc sites drive get --site-id "<site-id>"
# Returns drive id, webUrl, etc.
./mgc-cli/mgc drives items children list \
--drive-id "<drive-id>" \
--drive-item-id "<folder-item-id>" \
--select "id,name"
Use root item ID from mgc drives root get --drive-id <drive-id> as the starting point.
Use the bundled script — it handles ID resolution, file entry creation, and content upload automatically:
python3 .claude/skills/msgraph-files/scripts/upload_file.py \
--site "softwarearchitects1com.sharepoint.com:/backoffice" \
--folder "Buchhaltung/Belege-Rainer/oebb" \
/path/to/file.pdf
# With an explicit drive-id (skip site resolution, faster)
python3 .claude/skills/msgraph-files/scripts/upload_file.py \
--drive-id "<drive-id>" \
--folder "Buchhaltung/Belege-Rainer/oebb" \
/path/to/file.pdf
# Overwrite if exists (default: error if file already exists)
python3 .claude/skills/msgraph-files/scripts/upload_file.py \
--site "softwarearchitects1com.sharepoint.com:/backoffice" \
--folder "Buchhaltung/Belege-Rainer/oebb" \
--overwrite \
/path/to/file.pdf
mgc does not have a single-command upload-to-path. The process is:
Step 1 — create an empty file entry in the target folder:
./mgc-cli/mgc drives items children create \
--drive-id "<drive-id>" \
--drive-item-id "<folder-item-id>" \
--body '{"name":"filename.pdf","file":{}}'
# Returns a drive item with an id and size 0
Step 2 — upload the content:
./mgc-cli/mgc drives items content put \
--drive-id "<drive-id>" \
--drive-item-id "<new-file-item-id>" \
--input-file "/path/to/file.pdf"
# Returns the updated drive item with the correct size
Use the bundled script — it resolves sharing URLs, navigates paths, and downloads in one step:
# From a SharePoint sharing URL (e.g. "Copy link" from SharePoint UI)
python3 .claude/skills/msgraph-files/scripts/download_file.py \
--share-url "https://tenant.sharepoint.com/:b:/g/site/ITEM?e=TOKEN"
# By path within a site (navigates folder tree automatically)
python3 .claude/skills/msgraph-files/scripts/download_file.py \
--site "softwarearchitects1com.sharepoint.com:/backoffice" \
--path "Buchhaltung/Belege-Rainer/ticket.pdf"
# By path with a known drive-id (faster, skips site resolution)
python3 .claude/skills/msgraph-files/scripts/download_file.py \
--drive-id "<drive-id>" \
--path "Buchhaltung/Belege-Rainer/ticket.pdf"
# Direct by item id (output path required)
python3 .claude/skills/msgraph-files/scripts/download_file.py \
--drive-id "<drive-id>" \
--item-id "<item-id>" \
--output /tmp/downloaded.pdf
Default output path is ./<filename> (current directory, original filename).
Use --output <path> to override.
SharePoint sharing URLs are encoded for the Graph /shares endpoint:
import base64
share_id = "u!" + base64.urlsafe_b64encode(url.encode()).decode().rstrip("=")
# Then: mgc shares drive-item get --shared-drive-item-id <share_id>
# Returns drive id + item id needed for content download
./mgc-cli/mgc drives items content get \
--drive-id "<drive-id>" \
--drive-item-id "<file-item-id>" \
--output-file /tmp/downloaded.pdf
When you need the item ID of a folder deep in the tree:
# 1. Get root item ID
./mgc-cli/mgc drives root get --drive-id "<drive-id>" --select "id,name"
# 2. List root children, find the next folder's id
./mgc-cli/mgc drives items children list \
--drive-id "<drive-id>" --drive-item-id "<root-id>" --select "id,name"
# 3. Repeat until you reach the target folder
The upload script automates this navigation given a slash-delimited folder path.
These are stable and can be reused to skip resolution steps:
| Resource | ID |
|---|---|
Site (/backoffice) | softwarearchitects1com.sharepoint.com,1ad35ca4-c33c-4f39-b879-66989de76ac9,b58e40ac-8840-4c8b-805b-6e4e661e6072 |
| Drive (Shared Documents) | b!pFzTGjzDOU-4eWaYnedqyaxAjrVAiItMgFtuTmYeYHL6X5UxYPEpRK3qBk-NBEEl |
| Root item | 015KPENK56Y2GOVW7725BZO354PWSELRRZ |
Buchhaltung | 015KPENKYDQQBET2SUDVA3CQ57JPSRJ3V4 |
Buchhaltung/Belege-Rainer | 015KPENK6R2YDBPRVOL5GLUU55YKMYXKIR |
Buchhaltung/Belege-Rainer/oebb | 015KPENK36CG3JBFNGS5ELARYB2CUML5QT |
403 accessDenied on drive endpoints → re-login with Sites.ReadWrite.All--overwrite flag on the upload script, or delete first with mgc drives items delete--input-file path must be absolute or relative to cwd where mgc is invokedshares drive-item get fails with 403 → the sharing URL may require the ?e=TOKEN query parameter; ensure the full URL including the token is passedUse this skill when the user asks to parse, perform multi-format document conversion or spatially extract text from an unstructured file (PDF, DOCX, PPTX, XLSX, images, etc.) locally without cloud dependencies.
How to authenticate with Microsoft Graph CLI (mgc) — login, logout, scopes, and auth strategies. Use this skill whenever the user needs to sign in to Microsoft 365, configure mgc authentication, manage Graph API scopes, or troubleshoot 401 Unauthorized errors with the mgc CLI.
How to read, create, update, and manage Outlook calendar events via the Microsoft Graph CLI (mgc). Use this skill whenever the user wants to work with their Microsoft 365 calendar — listing events, checking the week's schedule, creating meetings, accepting or declining invitations, finding available meeting times, or managing Teams online meetings.
How to read, search, filter, send, reply, forward, and manage Outlook email via the Microsoft Graph CLI (mgc). Use this skill whenever the user wants to work with email in Microsoft 365 / Outlook — searching messages, checking unread mail, sending emails, downloading attachments, managing folders, or handling the Focused Inbox.