An Agent Skill that gives AI agents up-to-date knowledge of the complete Microsoft Graph API — and optionally executes calls directly.

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.

This skill bundles the complete Microsoft Graph API surface as local indexes — searchable instantly with zero network calls.

• Complete Microsoft Graph API Knowledge — 27,700 Graph APIs, all indexed locally
• Instant Local Search — All lookups run locally in milliseconds, no network calls needed
• Community Samples — Curated, hand-verified samples mapping tasks to exact API queries
• MCP Server Compatible — Works with lokka.dev or any Microsoft Graph MCP server for execution
• Direct API Execution — Authenticate and call the Microsoft Graph API directly when no MCP server is available
• MSAL Authentication — Interactive browser flow with device code fallback, plus app-only auth
• Safe by Default — GET operations allowed; write operations require explicit confirmation
• Cross-Platform — Works on macOS, Linux, and Windows (amd64/arm64) with zero runtime dependencies

Using skills.sh (recommended):

npx skills add merill/msgraph

Or download from GitHub Releases:

Download msgraph.zip from the latest release, 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 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

# Sign in
msgraph auth signin

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

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

Requires Go 1.22+ to build from source.

# Build for current platform
make build

# Build for all platforms
make build-all

# Run the OpenAPI indexer
make index

msgraph/
├── samples/          # Community YAML sample files by product
├── skills/msgraph/   # The installable Agent Skill
│   ├── SKILL.md      # Agent Skills spec entry point
│   ├── scripts/      # Launcher scripts + binary cache
│   └── references/   # OpenAPI index, API docs index, samples index, reference docs
├── cmd/              # CLI subcommands (Cobra)
├── internal/         # Internal packages
├── tools/            # Build-time tools (OpenAPI indexer)
├── docs/             # Documentation site (Astro + Starlight)
└── .github/          # CI/CD workflows

MIT