microsoft-graph — Claude Code skill: what it does, how to install
A hub for Microsoft Graph work: eight reference files, shared query parameters and permission rules. Useful when the agent is writing a Microsoft 365 integration.
no license 263 installs ★ 25 updated 2026-02-19
npx skills add markpitt/claude-skills --skill microsoft-graph -a claude-codeWhat microsoft-graph does
Microsoft Graph is one REST endpoint for Microsoft 365 data, based at https://graph.microsoft.com/{version}/{resource}, in v1.0 or beta. The skill carries eight reference files for it: app registration and OAuth, users and groups, mail, calendar, OneDrive and SharePoint, Teams, Planner/To Do/OneNote, security and reports.
A task table maps the job to a file. Before that the agent answers four questions: which resource, which action, whose identity, and whether permissions are delegated or application-level. Each file then supplies endpoints, CRUD examples and the permission list. Shared pieces live in the hub: $select and $filter, sorting with $orderby, paging through @odata.nextLink, POST /$batch for 1 to 20 calls, delta queries for change tracking.
Auth runs on OAuth 2.0 through Azure AD. Skip the app registration, or leave permissions ungranted, and calls come back 403; that fix belongs in the Azure portal, not in the skill.
What it helps with
- build a Graph API call with the right
$selectand$filter - find the file that covers mail, calendar or OneDrive work
- work out which permissions an app needs before the first call
- add paging and batch requests to an existing integration
- handle 429 responses without breaking the sync
Example prompts for the agent
- Pull the user list from Azure AD with
$select=displayName,mailand group it by department. - Set up OAuth 2.0 for a new app registration and list the scopes needed to read mail.
- Page through the OneDrive file listing with
@odata.nextLinkand save the file names.
How to install microsoft-graph
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill microsoft-graph -a claude-code2Manually: put the files in place
~/.claude/skills/microsoft-graph/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/microsoft-graph/
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill microsoft-graph -a codex2Manually: put the files in place
.agents/skills/microsoft-graph/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill microsoft-graph -a cursor2Manually: put the files in place
.cursor/skills/microsoft-graph/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install markpitt/claude-skills skills/microsoft-graph2Manually: put the files in place
.github/skills/microsoft-graph/SKILL.md1Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill microsoft-graph -a gemini-cli2Platform CLI
gemini skills install https://github.com/markpitt/claude-skills --path skills/microsoft-graphManually: put the files in place
.devin/skills/microsoft-graph/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill microsoft-graph -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about microsoft-graph
How do I install microsoft-graph in Claude Code?
Run npx skills add markpitt/claude-skills --skill microsoft-graph -a claude-code. The skill lands at ~/.claude/skills/microsoft-graph/SKILL.md.
What does the microsoft-graph skill do?
It sends the agent to the right Graph API reference for the job, with endpoints, request examples and the permissions each call needs. Query parameters and error handling sit in the hub itself.
What do I need before making Graph calls?
An app registration in Azure AD plus OAuth 2.0. Without granted permissions the response is 403, and the change happens in the Azure portal.