Agent Skills

msgraph

Microsoft Graph Skill for Agents

Instalação
CLI
npx skills add https://github.com/merill/msgraph --skill msgraph

Instale esta skill com a CLI e comece a usar o fluxo de trabalho SKILL.md em seu espaço de trabalho.

Última atualização em 4/22/2026

msgraph

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

The Problem

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.

The Solution

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

Index Count
OpenAPI endpoints 27,700+
Endpoint docs (permissions, query params, headers) 6,200+
Resource schemas (properties, types, filter operators) 4,200+
Community samples Growing

Features

  • 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

Quick Start

Install the Skill

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 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

Configuration

Environment Variable Description Default
MSGRAPH_CLIENT_ID Override the default app client ID 14d82eec-204b-4c2f-b7e8-296a70dab67e
MSGRAPH_TENANT_ID Target a specific tenant common
MSGRAPH_API_VERSION Default API version (beta or v1.0) beta
MSGRAPH_NO_TOKEN_CACHE Disable persisted token cache (in-memory only) false

Building from Source

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

Project Structure

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

License

MIT