msgraph

command module

v1.0.19 Latest Latest Go to latest Published: Mar 26, 2026 License: MIT Imports: 3 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/merill/msgraph

Links

README ¶

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

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

Path	Synopsis
cmd Package cmd implements the CLI commands for msgraph.	Package cmd implements the CLI commands for msgraph.
internal
apidocs Package apidocs provides search functionality over a pre-processed index of Microsoft Graph API documentation, including per-endpoint permissions, query parameters, and per-resource property details.	Package apidocs provides search functionality over a pre-processed index of Microsoft Graph API documentation, including per-endpoint permissions, query parameters, and per-resource property details.
auth Package auth provides authentication for Microsoft Graph using MSAL.	Package auth provides authentication for Microsoft Graph using MSAL.
config Package config provides configuration management for the msgraph CLI.	Package config provides configuration management for the msgraph CLI.
ftsutil Package ftsutil provides shared utilities for building and querying SQLite FTS5 full-text search databases.	Package ftsutil provides shared utilities for building and querying SQLite FTS5 full-text search databases.
graph Package graph provides an HTTP client for Microsoft Graph API calls with built-in safety enforcement and incremental consent support.	Package graph provides an HTTP client for Microsoft Graph API calls with built-in safety enforcement and incremental consent support.
openapi Package openapi provides search functionality over a pre-processed Microsoft Graph OpenAPI index.	Package openapi provides search functionality over a pre-processed Microsoft Graph OpenAPI index.
samples Package samples provides search functionality over community-contributed Microsoft Graph API query samples.	Package samples provides search functionality over community-contributed Microsoft Graph API query samples.
tools
api-docs-indexer command Command api-docs-indexer downloads and processes the Microsoft Graph API documentation into a compact searchable JSON index containing per-endpoint permissions, query parameters, and per-resource property details.	Command api-docs-indexer downloads and processes the Microsoft Graph API documentation into a compact searchable JSON index containing per-endpoint permissions, query parameters, and per-resource property details.
concept-docs-builder command Command concept-docs-builder downloads Microsoft Graph concept documentation, strips SDK code tabs and boilerplate, and outputs clean HTTP-only markdown files suitable for LLM consumption.	Command concept-docs-builder downloads Microsoft Graph concept documentation, strips SDK code tabs and boilerplate, and outputs clean HTTP-only markdown files suitable for LLM consumption.
openapi-indexer command Command openapi-indexer downloads and processes the Microsoft Graph OpenAPI specification into a compact searchable JSON index and a SQLite FTS5 full-text search database.	Command openapi-indexer downloads and processes the Microsoft Graph OpenAPI specification into a compact searchable JSON index and a SQLite FTS5 full-text search database.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL