{
  "markdown": "# msgraph\n\nAn [Agent Skill](https://agentskills.io) that gives AI agents up-to-date knowledge of the complete Microsoft Graph API — and optionally executes calls directly.\n\n## The Problem\n\nLLMs 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.\n\n## The Solution\n\nThis skill bundles the complete Microsoft Graph API surface as local indexes — searchable instantly with zero network calls.\n\n| Index | Count |\n|---|---|\n| OpenAPI endpoints | **27,700+** |\n| Endpoint docs (permissions, query params, headers) | **6,200+** |\n| Resource schemas (properties, types, filter operators) | **4,200+** |\n| Community samples | **Growing** |\n\n## Features\n\n- **Complete Microsoft Graph API Knowledge** — 27,700 Graph APIs, all indexed locally\n- **Instant Local Search** — All lookups run locally in milliseconds, no network calls needed\n- **Community Samples** — Curated, hand-verified samples mapping tasks to exact API queries\n- **MCP Server Compatible** — Works with [lokka.dev](https://lokka.dev) or any Microsoft Graph MCP server for execution\n- **Direct API Execution** — Authenticate and call the Microsoft Graph API directly when no MCP server is available\n- **MSAL Authentication** — Interactive browser flow with device code fallback, plus app-only auth\n- **Safe by Default** — GET operations allowed; write operations require explicit confirmation\n- **Cross-Platform** — Works on macOS, Linux, and Windows (amd64/arm64) with zero runtime dependencies\n\n## Quick Start\n\n### Install the Skill\n\n**Using [skills.sh](https://skills.sh) (recommended):**\n\n```bash\nnpx skills add merill/msgraph\n```\n\n**Or download from GitHub Releases:**\n\nDownload `msgraph.zip` from the [latest release](https://github.com/merill/msgraph/releases/latest), then extract it into your agent's skills directory:\n\n```bash\n# Download and extract\ncurl -fsSL -o msgraph.zip https://github.com/merill/msgraph/releases/latest/download/msgraph.zip\nunzip msgraph.zip -d ~/.claude/skills/\n```\n\n### Search the Microsoft Graph API (no auth needed)\n\n```bash\n# Search curated samples\nmsgraph sample-search --query \"conditional access policies\"\n\n# Look up endpoint docs with permissions\nmsgraph api-docs-search --endpoint /users --method GET\n\n# Search 27,700 Graph APIs\nmsgraph openapi-search --query \"send mail\"\n\n# Look up resource schema and filter operators\nmsgraph api-docs-search --resource user\n```\n\n### Execute Microsoft Graph API Calls (auth required)\n\n```bash\n# Sign in\nmsgraph auth signin\n\n# Get current user profile\nmsgraph graph-call GET /me\n\n# List messages\nmsgraph graph-call GET /me/messages --top 10\n```\n\n## Configuration\n\n| Environment Variable | Description | Default |\n|---|---|---|\n| `MSGRAPH_CLIENT_ID` | Override the default app client ID | `14d82eec-204b-4c2f-b7e8-296a70dab67e` |\n| `MSGRAPH_TENANT_ID` | Target a specific tenant | `common` |\n| `MSGRAPH_API_VERSION` | Default API version (`beta` or `v1.0`) | `beta` |\n| `MSGRAPH_NO_TOKEN_CACHE` | Disable persisted token cache (in-memory only) | `false` |\n\n## Building from Source\n\nRequires [Go 1.22+](https://go.dev/dl/) to build from source.\n\n```bash\n# Build for current platform\nmake build\n\n# Build for all platforms\nmake build-all\n\n# Run the OpenAPI indexer\nmake index\n```\n\n## Project Structure\n\n```\nmsgraph/\n├── samples/          # Community YAML sample files by product\n├── skills/msgraph/   # The installable Agent Skill\n│   ├── SKILL.md      # Agent Skills spec entry point\n│   ├── scripts/      # Launcher scripts + binary cache\n│   └── references/   # OpenAPI index, API docs index, samples index, reference docs\n├── cmd/              # CLI subcommands (Cobra)\n├── internal/         # Internal packages\n├── tools/            # Build-time tools (OpenAPI indexer)\n├── docs/             # Documentation site (Astro + Starlight)\n└── .github/          # CI/CD workflows\n```\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 4011,
  "sha": "f2a353c2d676922431b158e59498e0ade57ca4ec221a2fa1d19f2a379ea31197",
  "repo_slug": "merill/msgraph",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_merill_msgraph_msgraph_b4ac62cf/readme"
}