Agent skill

Msgraph Files

by automateyournetwork in automateyournetwork/netclaw

Read OneDrive and SharePoint files via the Microsoft 365 MCP server — list folder contents, fetch item metadata, inspect versions and sharing permissions.

Apache-2.0Auto-check passedDocuments & Office

Install Msgraph Files

skills CLI
$ npx skills add automateyournetwork/netclaw --skill msgraph-files -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install automateyournetwork/netclaw msgraph-files --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/automateyournetwork/netclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/workspace/skills/msgraph-files .claude/skills/msgraph-files && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
msgraph-files
GitHub stars
675
Token cost
~1k tokens
SKILL.md length
466 words
Files
1
Skills in repo
120
Repo updated
First seen
Licence
Apache-2.0

At a glance

Read OneDrive and SharePoint files via the Microsoft 365 MCP server — list folder contents, fetch item metadata, inspect versions and sharing permissions.

  • Works in 5 steps: verify-login — is there a live session?… → list-folder-files from the drive root,… → get-drive-item for the candidate — size,… → …
  • Locating a document in OneDrive/SharePoint
  • SKILL.md covers MCP Server, Verified tools, Workflow: locate and inspect a… and Reading results honestly, plus 3 more sections
  • Calls npx

What it does

Msgraph Files is an agent skill from automateyournetwork/netclaw. Read OneDrive and SharePoint files via the Microsoft 365 MCP server — list folder contents, fetch item metadata, inspect versions and sharing permissions. Use when locating a document in OneDrive/SharePoint, checking who a file is shared with, or reviewing file version history

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Documents & Office, covering Cloud office suites. It works with Model Context Protocol, Microsoft 365, Microsoft OneDrive and Microsoft SharePoint. The repository describes itself as: An AI agent that claws through your network. The licence is Apache-2.0.

When your agent uses it

  • Locating a document in OneDrive/SharePoint
  • Checking who a file is shared with
  • Reviewing file version history

Example prompts

  • “/msgraph-files”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. verify-login — is there a live session? If not, login and surface the device code to
  2. list-folder-files from the drive root, then descend
  3. get-drive-item for the candidate — size, timestamps, path
  4. list-drive-item-permissions if the question is about sharing or exposure
  5. list-drive-item-versions if the question is "what changed and when"

What it can do on your machine

Read from SKILL.md and the folder at commit 95bb17e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • npmjs.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Msgraph Files loads about 1k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 466 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from automateyournetwork/netclaw at commit 95bb17e, republished under its Apache-2.0 licence (© automateyournetwork). 466 words, ~1,026 tokens.

Download SKILL.mdSave it as .claude/skills/msgraph-files/SKILL.md (or your agent's skills folder).
name
msgraph-files
description
Read OneDrive and SharePoint files via the Microsoft 365 MCP server — list folder contents, fetch item metadata, inspect versions and sharing permissions. Use when locating a document in OneDrive/SharePoint, checking who a file is shared with, or reviewing file version history
version
2.0.0
license
Apache-2.0
tags
microsoft365, onedrive, sharepoint, files, read-only

Microsoft 365 Files (read-only)

MCP Server

  • Package: @softeria/ms-365-mcp-server (MIT)
  • Invocation:
    npx -y @softeria/ms-365-mcp-server --read-only --enabled-tools 'drive-item|folder-files'
  • Requires: an Entra ID (Azure AD) app registration and delegated Graph scopes. The server handles the device-code sign-in itself via its login tool.

Version 2.0.0 replaced a package that did not exist. Until spec 093 this skill invoked npx -y @anthropic-ai/microsoft-graph-mcp, which 404s on npm, and documented seven graph_* tool names that exist in no server. Every call it described failed. The tool names below were read from the live server's tools/list, not recalled.

Why the --enabled-tools filter is mandatory

The unfiltered server exposes 188 tools measured at ~225,355 tokens — 45× NetClaw's 5,000 token manifest ceiling. It is unusable without a filter. The filter above lands 12 tools at ~4,599 tokens, which fits with little room to spare, so keep it narrow.

Verified tools

Read from the running server, --read-only with the filter above:

ToolWhat it does
list-folder-filescontents of a drive folder
get-drive-itemmetadata for one item by id or path
list-drive-item-versionsversion history of an item
list-drive-item-permissionswho an item is shared with
list-drive-item-thumbnailsavailable thumbnail renditions
login / verify-login / logoutdevice-code sign-in and session state
list-accounts / select-account / remove-accountmulti-account handling

There are no graph_* tools. If you find yourself reaching for one, it came from this skill's old text and does not exist.

Workflow: locate and inspect a document

  1. verify-login — is there a live session? If not, login and surface the device code to the operator; never fabricate a sign-in.
  2. list-folder-files from the drive root, then descend
  3. get-drive-item for the candidate — size, timestamps, path
  4. list-drive-item-permissions if the question is about sharing or exposure
  5. list-drive-item-versions if the question is "what changed and when"
Show full SKILL.md (186 more words)Show less

Reading results honestly

  • Read-only. No upload, move, rename or delete. --read-only strips them, and this skill must not offer them. Writing a file is msgraph-visio's narrower, write-enabled invocation.
  • A permission list is a point-in-time answer, and sharing links can be created outside this surface. "No permissions listed" is not "not shared."
  • An empty folder listing means this folder, as this account sees it. Delegated scopes and account selection both narrow what is visible; state which account you were signed in as.
  • list-accounts returning one account is not proof there is only one tenant.

Not verified

The tool names and manifest cost are measured; the calls themselves are not. Verifying a real fetch needs an M365 tenant and an app registration, which this environment does not have. Treat the workflows as correct-by-construction until run against a live tenant.

Integration with Other Skills

SkillHow They Work Together
msgraph-visioWriting a .vsdx back to OneDrive (write-enabled invocation)
document-generationProduces the documents this skill locates
gait-session-trackingRecord which account and item were accessed

Environment Variables

  • MS365_MCP_CLIENT_ID — Entra ID app registration (client) ID
  • MS365_MCP_TENANT_ID — tenant ID, or common for multi-tenant

© automateyournetwork, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in workspace/skills/msgraph-files of automateyournetwork/netclaw.

Open the folder on GitHubat commit 95bb17e

Compare with similar skills

Msgraph Files next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Msgraph Files compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Msgraph Files this skillautomateyournetwork/netclaw675—~1kAutomated safety check: PassApache-2.0
Workiqmicrosoft/work-iq1k—~15kAutomated safety check: PassCustom licence
Add Workiqmicrosoft/power-platform-skills972—~5.6kAutomated safety check: NotesMIT
Msgraphcodemie-ai/codemie-code294—~4.1kAutomated safety check: PassApache-2.0
aai-cli Microsoft 365aai-labs/agent-barn109—~1.2kAutomated safety check: PassApache-2.0
Workiq Previewmicrosoft/work-iq1k—~3.3kAutomated safety check: PassCustom licence

Similar skills

  • Workiq

    microsoft/work-iq

    Official

    WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.

    1k GitHub stars~15k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Add Workiq

    microsoft/power-platform-skills

    Official

    Adds Work IQ (M365 Copilot Search) to a Power Apps code app via the Work IQ Copilot MCP connector (shareda365copilotchatmcp), then wires up a production-ready McpSession wrapper for AI-powered…

    972 GitHub stars~5.6k tokensUpdated today
    Documents & OfficeAuto-check: notes
  • Msgraph

    codemie-ai/codemie-code

    Work with Microsoft 365 services via the Graph API — emails, calendar events, SharePoint sites (read and write), Teams chats and channel messages, OneDrive files, OneNote notebooks, Planner task…

    294 GitHub stars~4.1k tokensUpdated today
    Documents & OfficeAuto-check passed
  • aai-cli Microsoft 365

    aai-labs/agent-barn

    Guides work with Outlook, OneDrive, SharePoint, Teams, Excel, To Do and Planner through aai-cli's Microsoft Graph commands, starting from which service owns the data.

    109 GitHub stars~1.2k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Workiq Preview

    microsoft/work-iq

    Official

    WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.

    1k GitHub stars~3.3k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Microsoft 365

    HybridAIOne/hybridclaw

    Read Microsoft 365 data through Microsoft Graph: Outlook mail/calendar, OneDrive/SharePoint files, Teams, chats, and user profile.

    158 GitHub stars~1.4k tokensUpdated today
    Documents & OfficeAuto-check passed

More from automateyournetwork/netclaw

All 120 skills in this repo
  • EVE-NG Lab Topology Design

    automateyournetwork/netclaw

    Entry point for designing EVE-NG network labs: classifies the request, gathers missing requirements, proposes options and validates the resulting topology.

    675 GitHub stars~612 tokensUpdated 2 days ago
    Auto-check passed
  • ACI Policy Change Deployment

    automateyournetwork/netclaw

    Deploys Cisco ACI policy changes only behind an approved ServiceNow Change Request, capturing pre and post-change fault baselines and rolling back automatically on a fault delta.

    675 GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check passed
  • Cisco ACI Fabric Health Audit

    automateyournetwork/netclaw

    Runs a phased health audit of a Cisco ACI fabric through MCP tools: node status, links, tenant and policy review, faults and endpoint learning.

    675 GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed
  • Anta Validation

    automateyournetwork/netclaw

    Validate Arista EOS network state against ANTA's pre-built 208-test catalogue, with structured pass/fail verdicts.

    675 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • Arista Cvp

    automateyournetwork/netclaw

    Arista CloudVision Portal (CVP) automation via REST API — device inventory, events, connectivity monitoring, tag management (4 tools).

    675 GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check: notes
  • AWS Cloud Monitoring

    automateyournetwork/netclaw

    AWS CloudWatch monitoring — metrics, alarms, log queries, VPC flow log analysis, network performance.

    675 GitHub stars~1k tokensUpdated 2 days ago
    Auto-check passed

Questions about Msgraph Files

What does Msgraph Files do?

Read OneDrive and SharePoint files via the Microsoft 365 MCP server — list folder contents, fetch item metadata, inspect versions and sharing permissions. Msgraph Files is an agent skill from automateyournetwork/netclaw. Read OneDrive and SharePoint files via the Microsoft 365 MCP server — list folder contents, fetch item metadata, inspect versions and sharing permissions.

When should I use Msgraph Files?

Msgraph Files fits situations like: locating a document in OneDrive/SharePoint; checking who a file is shared with; reviewing file version history.

How do I install Msgraph Files in Claude Code?

Run `npx skills add automateyournetwork/netclaw --skill msgraph-files -a claude-code`. Or copy the skill folder (workspace/skills/msgraph-files in automateyournetwork/netclaw) into .claude/skills/msgraph-files in your project. Claude Code loads it when a task matches its description.

How do I install Msgraph Files in Codex?

Run `npx skills add automateyournetwork/netclaw --skill msgraph-files -a codex`. Or copy the skill folder (workspace/skills/msgraph-files in automateyournetwork/netclaw) into .agents/skills/msgraph-files in your project. Codex loads it when a task matches its description.

Can I use Msgraph Files in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add automateyournetwork/netclaw --skill msgraph-files -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/msgraph-files, .gemini/skills/msgraph-files, .github/skills/msgraph-files and .opencode/skills/msgraph-files in your project.

What does Msgraph Files need to run?

Going by SKILL.md and its folder, Msgraph Files needs the command-line tools its instructions call (npx). Our summary lists: Node.js.

Does Msgraph Files access the network?

SKILL.md names 1 domain. As links in the text: npmjs.com. This is read from the text; nothing was executed.

Is Msgraph Files safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Msgraph Files use?

Msgraph Files is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Msgraph Files use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Msgraph Files?

Skills that share tags, products or a category with Msgraph Files: Workiq (microsoft/work-iq, 1k stars), Add Workiq (microsoft/power-platform-skills, 972 stars), Msgraph (codemie-ai/codemie-code, 294 stars) and aai-cli Microsoft 365 (aai-labs/agent-barn, 109 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Msgraph Files?

automateyournetwork (a GitHub user) maintains it in automateyournetwork/netclaw, which has 675 GitHub stars. The repository holds 120 skills in this directory. The repository was last updated on October 5, 2026.

Source: automateyournetwork/netclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.