/msgraph
Up-to-date Microsoft Graph API knowledge for AI agents. Search 27,700+ Graph APIs, endpoint docs, resource schemas, and community samples — all locally, no network calls. Use when the agent needs to find, understand, or call Microsoft Graph endpoints.
$ npx -y skills add merill/msgraph --skill msgraph --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/msgraph
Context preview
The summary Claude sees to decide when to auto-load this skill.
Up-to-date Microsoft Graph API knowledge for AI agents. Search 27,700+ Graph APIs, endpoint docs, resource schemas, and community samples — all locally, no network calls. Use when the agent needs to find, understand, or call Microsoft Graph endpoints.
SKILL.md
msgraph.SKILL.mdname: msgraph
description: Up-to-date Microsoft Graph API knowledge for AI agents. Search 27,700+ Graph APIs, endpoint docs, resource schemas, and community samples — all locally, no network calls. Use when the agent needs to find, understand, or call Microsoft Graph endpoints.
license: MIT
metadata:
author: merill
version: "1.0.19"
Microsoft Graph Agent Skill
Search, look up, and call any of the 27,700+ Microsoft Graph APIs — all locally, no network calls needed. Use the three search commands to find the right endpoint, check permissions and parameters, then optionally execute calls directly or hand off to a Graph MCP server.
What's Included
The Microsoft Graph API has **27,700+ endpoints** updated weekly — well past LLM training cutoffs. This skill bundles the complete API surface as local indexes that you search instantly with no network calls.
| Index | Count | What it contains | |---|---|---| | OpenAPI endpoints | 27,700+ | Path, method, summary, description, permission scopes | | Endpoint docs | 6,200+ | Permissions (delegated/app), query parameters, required headers, default vs `$select`-only properties | | Resource schemas | 4,200+ | All properties with types, supported `$filter` operators, default/select-only flags | | Community samples | Growing | Hand-verified queries mapping natural-language tasks to exact API calls |
How to Run
The `msgraph` CLI is bundled with this skill. Run all commands through the launcher script in this skill's directory:
- **macOS / Linux**: `bash <path-to-this-skill>/scripts/run.sh <command> [args...]`
- **Windows**: `powershell <path-to-this-skill>/scripts/run.ps1 <command> [args...]`
For example, to search for mail-related APIs on macOS:
bash /home/user/.opencode/skills/msgraph/scripts/run.sh openapi-search --query "send mail"
In all examples below, `msgraph` is shorthand for the full launcher invocation.
Finding the Right API
This is the primary purpose of the skill. Follow this progressive lookup strategy — each level adds detail:
1. **Your own knowledge** — try first for well-known endpoints (`/me`, `/users`, `/groups`). 2. **`sample-search`** — curated, hand-verified samples. Highest quality. Use for common tasks and multi-step workflows. 3. **`api-docs-search`** — per-endpoint permissions, supported query parameters, required headers, default vs `$select`-only properties, and resource property details with filter operators. 4. **`openapi-search`** — full catalog of 27,700 Graph APIs. Use when you cannot find the endpoint any other way. 5. **Reference files** — concept docs on query parameters, advanced queries, paging, batching, throttling, errors, and best practices. Read only when you need specific guidance.
This order is guidance — adapt based on the task. For example, jump straight to `api-docs-search` if you already know the endpoint but need its permissions.
sample-search
Search curated community samples that map natural-language tasks to exact Microsoft Graph API queries:
msgraph sample-search --query "conditional access policies"
msgraph sample-search --product entra
msgraph sample-search --query "managed devices" --product intune
| Flag | Description | |---|---| | `--query` | Free-text search (searches intent and query fields) | | `--product` | Filter by product: `entra`, `intune`, `exchange`, `teams`, `sharepoint`, `security`, `general` | | `--limit` | Max results (default 10) |
At least one of `--query` or `--product` is required. Results include multi-step workflows.
api-docs-search
Look up detailed documentation for a specific endpoint or resource type:
msgraph api-docs-search --endpoint /users --method GET
msgraph api-docs-search --resource user
msgraph api-docs-search --query "ConsistencyLevel"
| Flag | Description | |---|---| | `--endpoint` | Search by endpoint path (e.g. `/users`, `/me/messages`) | | `--resource` | Search by resource type name (e.g. `user`, `group`, `message`) | | `--method` | Filter by HTTP method: `GET`, `POST`, `PUT`, `PATCH` | | `--query` | Free-text search across all fields | | `--limit` | Max results (default 10) |
At least one of `--endpoint`, `--resource`, or `--query` is required.
**Endpoint results** include: required permissions (delegated work/school, delegated personal, application), supported OData query parameters, required headers, default properties, and endpoint-specific notes.
**Resource results** include: all properties with types, supported `$filter` operators (eq, ne, startsWith, etc.), and whether each property is returned by default or requires `$select`.
openapi-search
Search the full OpenAPI catalog of 27,700 Microsoft Graph APIs:
msgraph openapi-search --query "send mail"
msgraph openapi-search --resource messages --method GET
| Flag | Description | |---|---| | `--query` | Free-text search (searches path, summary, description) | | `--resource` | Filter by resource name (e.g. `users`, `groups`, `messages`) | | `--method` | Filter by HTTP method | | `--limit` | Max results (default 20) |
At least one of `--query`, `--resource`, or `--method` is required.
Using with MCP Servers
If the agent has access to a Microsoft Graph MCP server (such as [lokka.dev](https://lokka.dev) or any other Microsoft Graph MCP server), use the search tools above to find the right endpoint, permissions, and request syntax, then use the information with the MCP server for execution.
In this mode, **no authentication through this skill is needed**. The skill acts purely as a knowledge layer — the MCP server handles authentication and API execution.
Direct Microsoft Graph API Execution
When no Graph MCP server is available, this skill can authenticate to Microsoft 365 and execute Microsoft Graph API calls directly.
Authentication
The tool supports **delegated (user)** and **app-only (application)** authentication, auto-detected from environment variables.
**Quick start:**
msgraph auth status
Read more
name: msgraph description: Up-to-date Microsoft Graph API knowledge for AI agents. Search 27,700+ Graph APIs, endpoint docs, resource schemas, and community samples — all locally, no network calls. Use when the agent needs to find, understand, or call Microsoft Graph endpoints. license: MIT metadata: author: merill version: "1.0.19"
Microsoft Graph Agent Skill
Search, look up, and call any of the 27,700+ Microsoft Graph APIs — all locally, no network calls needed. Use the three search commands to find the right endpoint, check permissions and parameters, then optionally execute calls directly or hand off to a Graph MCP server.
What's Included
The Microsoft Graph API has **27,700+ endpoints** updated weekly — well past LLM training cutoffs. This skill bundles the complete API surface as local indexes that you search instantly with no network calls.
| Index | Count | What it contains | |---|---|---| | OpenAPI endpoints | 27,700+ | Path, method, summary, description, permission scopes | | Endpoint docs | 6,200+ | Permissions (delegated/app), query parameters, required headers, default vs `$select`-only properties | | Resource schemas | 4,200+ | All properties with types, supported `$filter` operators, default/select-only flags | | Community samples | Growing | Hand-verified queries mapping natural-language tasks to exact API calls |
How to Run
The `msgraph` CLI is bundled with this skill. Run all commands through the launcher script in this skill's directory:
- **macOS / Linux**: `bash <path-to-this-skill>/scripts/run.sh <command> [args...]`
- **Windows**: `powershell <path-to-this-skill>/scripts/run.ps1 <command> [args...]`
For example, to search for mail-related APIs on macOS:
bash /home/user/.opencode/skills/msgraph/scripts/run.sh openapi-search --query "send mail"
In all examples below, `msgraph` is shorthand for the full launcher invocation.
Finding the Right API
This is the primary purpose of the skill. Follow this progressive lookup strategy — each level adds detail:
1. **Your own knowledge** — try first for well-known endpoints (`/me`, `/users`, `/groups`). 2. **`sample-search`** — curated, hand-verified samples. Highest quality. Use for common tasks and multi-step workflows. 3. **`api-docs-search`** — per-endpoint permissions, supported query parameters, required headers, default vs `$select`-only properties, and resource property details with filter operators. 4. **`openapi-search`** — full catalog of 27,700 Graph APIs. Use when you cannot find the endpoint any other way. 5. **Reference files** — concept docs on query parameters, advanced queries, paging, batching, throttling, errors, and best practices. Read only when you need specific guidance.
This order is guidance — adapt based on the task. For example, jump straight to `api-docs-search` if you already know the endpoint but need its permissions.
sample-search
Search curated community samples that map natural-language tasks to exact Microsoft Graph API queries:
msgraph sample-search --query "conditional access policies" msgraph sample-search --product entra msgraph sample-search --query "managed devices" --product intune
| Flag | Description | |---|---| | `--query` | Free-text search (searches intent and query fields) | | `--product` | Filter by product: `entra`, `intune`, `exchange`, `teams`, `sharepoint`, `security`, `general` | | `--limit` | Max results (default 10) |
At least one of `--query` or `--product` is required. Results include multi-step workflows.
api-docs-search
Look up detailed documentation for a specific endpoint or resource type:
msgraph api-docs-search --endpoint /users --method GET msgraph api-docs-search --resource user msgraph api-docs-search --query "ConsistencyLevel"
| Flag | Description | |---|---| | `--endpoint` | Search by endpoint path (e.g. `/users`, `/me/messages`) | | `--resource` | Search by resource type name (e.g. `user`, `group`, `message`) | | `--method` | Filter by HTTP method: `GET`, `POST`, `PUT`, `PATCH` | | `--query` | Free-text search across all fields | | `--limit` | Max results (default 10) |
At least one of `--endpoint`, `--resource`, or `--query` is required.
**Endpoint results** include: required permissions (delegated work/school, delegated personal, application), supported OData query parameters, required headers, default properties, and endpoint-specific notes.
**Resource results** include: all properties with types, supported `$filter` operators (eq, ne, startsWith, etc.), and whether each property is returned by default or requires `$select`.
openapi-search
Search the full OpenAPI catalog of 27,700 Microsoft Graph APIs:
msgraph openapi-search --query "send mail" msgraph openapi-search --resource messages --method GET
| Flag | Description | |---|---| | `--query` | Free-text search (searches path, summary, description) | | `--resource` | Filter by resource name (e.g. `users`, `groups`, `messages`) | | `--method` | Filter by HTTP method | | `--limit` | Max results (default 20) |
At least one of `--query`, `--resource`, or `--method` is required.
Using with MCP Servers
If the agent has access to a Microsoft Graph MCP server (such as [lokka.dev](https://lokka.dev) or any other Microsoft Graph MCP server), use the search tools above to find the right endpoint, permissions, and request syntax, then use the information with the MCP server for execution.
In this mode, **no authentication through this skill is needed**. The skill acts purely as a knowledge layer — the MCP server handles authentication and API execution.
Direct Microsoft Graph API Execution
When no Graph MCP server is available, this skill can authenticate to Microsoft 365 and execute Microsoft Graph API calls directly.
Authentication
The tool supports **delegated (user)** and **app-only (application)** authentication, auto-detected from environment variables.
**Quick start:**
msgraph auth status
An Agent Skill that gives AI agents up-to-date knowledge of the complete Microsoft Graph API — and optionally executes calls directly.