Skip to content
Back to search

msgraph

Microsoft Graph Skill for Agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/merill/msgraph with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/merill/msgraph'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/merill-msgraph/badge.svg)](/listings/merill-msgraph)

HTML

<a href="/listings/merill-msgraph"><img src="/api/listings/merill-msgraph/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install the Skill

**Using [skills.sh](https://skills.sh) (recommended):**

npx skills add merill/msgraph

**Or download from GitHub Releases:**

Download `msgraph.zip` from the [latest release](https://github.com/merill/msgraph/releases/latest), then extract it into your agent's skills directory:

# Download and extract
curl -fsSL -o msgraph.zip https://github.com/merill/msgraph/releases/latest/download/msgraph.zip
unzip msgraph.zip -d ~/.claude/skills/

Search the Microsoft Graph API (no auth needed)

# Search curated samples
msgraph sample-search --query "conditional access policies"

# Look up endpoint docs with permissions
msgraph api-docs-search --endpoint /users --method GET

# Search 27,700 Graph APIs
msgraph openapi-search --query "send mail"

# Look up resource schema and filter operators
msgraph api-docs-search --resource user

Execute Microsoft Graph API Calls (auth required)

# Sign in
msgraph auth signin

# Get current user profile
msgraph graph-call GET /me

# List messages
msgraph graph-call GET /me/messages --top 10

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 122 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # msgraph
  2. An [Agent Skill](https://agentskills.io) that gives AI agents up-to-date knowledge of the complete Microsoft Graph API — and optionally executes calls directly.
  3. ## The Problem
  4. LLMs are trained on data that is months old. The Microsoft Graph API has **27,700 Graph APIs** and is updated weekly. Without current API knowledge, agents hallucinate endpoints, use deprecated paths, and miss required permissions.
  5. ## The Solution
  6. This skill bundles the complete Microsoft Graph API surface as local indexes — searchable instantly with zero network calls.
  7. | Index | Count |
  8. |---|---|
  9. | OpenAPI endpoints | **27,700+** |
  10. | Endpoint docs (permissions, query params, headers) | **6,200+** |
  11. | Resource schemas (properties, types, filter operators) | **4,200+** |
  12. | Community samples | **Growing** |
  13. ## Features
  14. - **Complete Microsoft Graph API Knowledge** — 27,700 Graph APIs, all indexed locally
  15. - **Instant Local Search** — All lookups run locally in milliseconds, no network calls needed
  16. - **Community Samples** — Curated, hand-verified samples mapping tasks to exact API queries
  17. - **MCP Server Compatible** — Works with [lokka.dev](https://lokka.dev) or any Microsoft Graph MCP server for execution
  18. - **Direct API Execution** — Authenticate and call the Microsoft Graph API directly when no MCP server is available
  19. - **MSAL Authentication** — Interactive browser flow with device code fallback, plus app-only auth
  20. - **Safe by Default** — GET operations allowed; write operations require explicit confirmation
  21. - **Cross-Platform** — Works on macOS, Linux, and Windows (amd64/arm64) with zero runtime dependencies
  22. ## Quick Start
  23. ### Install the Skill
  24. **Using [skills.sh](https://skills.sh) (recommended):**
  25. ```bash
  26. npx skills add merill/msgraph
  27. ```
  28. **Or download from GitHub Releases:**
  29. Download `msgraph.zip` from the [latest release](https://github.com/merill/msgraph/releases/latest), then extract it into your agent's skills directory:
  30. ```bash
  31. # Download and extract
  32. curl -fsSL -o msgraph.zip https://github.com/merill/msgraph/releases/latest/download/msgraph.zip
  33. unzip msgraph.zip -d ~/.claude/skills/
  34. ```
  35. ### Search the Microsoft Graph API (no auth needed)
  36. ```bash
  37. # Search curated samples
  38. msgraph sample-search --query "conditional access policies"
  39. # Look up endpoint docs with permissions
  40. msgraph api-docs-search --endpoint /users --method GET
  41. # Search 27,700 Graph APIs
  42. msgraph openapi-search --query "send mail"
  43. # Look up resource schema and filter operators
  44. msgraph api-docs-search --resource user
  45. ```
  46. ### Execute Microsoft Graph API Calls (auth required)
  47. ```bash
  48. # Sign in
  49. msgraph auth signin
  50. # Get current user profile
  51. msgraph graph-call GET /me
  52. # List messages
  53. msgraph graph-call GET /me/messages --top 10
  54. ```
  55. ## Configuration
  56. | Environment Variable | Description | Default |
  57. |---|---|---|
  58. | `MSGRAPH_CLIENT_ID` | Override the default app client ID | `14d82eec-204b-4c2f-b7e8-296a70dab67e` |
  59. | `MSGRAPH_TENANT_ID` | Target a specific tenant | `common` |
  60. | `MSGRAPH_API_VERSION` | Default API version (`beta` or `v1.0`) | `beta` |
  61. | `MSGRAPH_NO_TOKEN_CACHE` | Disable persisted token cache (in-memory only) | `false` |
  62. ## Building from Source
  63. Requires [Go 1.22+](https://go.dev/dl/) to build from source.
  64. ```bash
  65. # Build for current platform
  66. make build
  67. # Build for all platforms
  68. make build-all
  69. # Run the OpenAPI indexer
  70. make index
  71. ```
  72. ## Project Structure
  73. ```
  74. msgraph/
  75. ├── samples/ # Community YAML sample files by product
  76. ├── skills/msgraph/ # The installable Agent Skill
  77. │ ├── SKILL.md # Agent Skills spec entry point
  78. │ ├── scripts/ # Launcher scripts + binary cache
  79. │ └── references/ # OpenAPI index, API docs index, samples index, reference docs
  80. ├── cmd/ # CLI subcommands (Cobra)
  81. ├── internal/ # Internal packages
  82. ├── tools/ # Build-time tools (OpenAPI indexer)
  83. ├── docs/ # Documentation site (Astro + Starlight)
  84. └── .github/ # CI/CD workflows
  85. ```
  86. ## License
  87. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.