microsoft-graph by markpitt/claude-skills
npx skills add https://github.com/markpitt/claude-skills --skill microsoft-graphMicrosoft Graph 是一个统一的 REST API 端点,用于访问 Microsoft 365、Windows 和企业移动性 + 安全中的 Microsoft 云资源。基础 URL:https://graph.microsoft.com/{version}/{resource}
API 版本: v1.0 (生产环境) 或 beta (预览版)
身份验证: 通过 Azure AD 的 OAuth 2.0
数据格式: JSON
| 任务 | 服务 | 加载资源 |
|---|---|---|
| 设置身份验证、注册应用、管理凭据 | 应用与身份验证 | resources/authentication-apps.md |
| 管理用户、组、组织、目录 | 身份与访问 | resources/identity-access.md |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 电子邮件、文件夹、附件、规则、签名 | 邮件操作 | resources/mail-operations.md |
| 日历、事件、日程安排、会议、忙/闲状态 | 日历与日程安排 | resources/calendar-scheduling.md |
| 上传文件、文件夹、共享、OneDrive、SharePoint | 文件与存储 | resources/files-storage.md |
| Teams、频道、聊天、状态、在线会议 | Teams 与通信 | resources/teams-communications.md |
| Planner 任务、To Do 列表、OneNote 笔记本 | 规划与笔记 | resources/planning-notes.md |
| 安全警报、合规性、设备管理、报告 | 安全与治理 | resources/security-governance.md |
通过回答以下问题来确定您需要的服务领域:
使用上面的决策表查找您的资源文件。每个资源文件包含:
每个资源文件都展示了针对您的用例、可直接复制粘贴的实用示例。
标准查询参数:
$select=prop1,prop2 选择要返回的属性
$filter=startsWith(name,'A') 按条件筛选结果
$orderby=name desc 对结果排序 (升序或降序)
$top=25 限制为 25 条结果 (默认 20)
$skip=50 跳过前 50 条结果
$expand=members 包含相关/嵌套数据
$count=true 在响应中包含总计数
$search="keyword" 跨内容进行全文搜索
标准 CRUD 操作:
GET /me/messages?$select=subject&$top=10 # 读取
POST /me/events {"subject": "Meeting", ...} # 创建
PATCH /users/{id} {"jobTitle": "Manager"} # 更新
DELETE /me/messages/{id} # 删除
分页: 始终遵循响应中的 @odata.nextLink 以获取完整数据集
批量请求: 使用 POST /$batch 将 1-20 个操作合并到单个调用中
增量查询: 使用 GET /users/delta 通过 @odata.deltaLink 跟踪自上次查询以来的更改
错误响应格式:
{"error": {"code": "Code", "message": "Description"}}
常见状态码:
| 文件 | 重点 | 行数 |
|---|---|---|
| authentication-apps.md | 应用注册、OAuth、凭据 | 350+ |
| identity-access.md | 用户、组、组织、目录 | 350+ |
| mail-operations.md | 电子邮件、文件夹、附件、规则 | 400+ |
| calendar-scheduling.md | 事件、重复、会议、忙/闲状态 | 350+ |
| files-storage.md | OneDrive、SharePoint、上传、共享 | 400+ |
| teams-communications.md | Teams、频道、聊天、状态 | 350+ |
| planning-notes.md | Planner、To Do、OneNote | 350+ |
| security-governance.md | 安全、合规性、设备、报告 | 400+ |
性能: 使用 $select 获取特定属性,实现分页,缓存令牌,对批量操作使用批处理,对同步场景应用增量查询
安全: 安全存储令牌 (切勿在代码中),请求最小权限,对 Azure 使用托管标识,每 90 天轮换凭据,验证所有响应
开发: 先在 beta 端点测试,监控弃用通知,为重试实施指数退避,遵守速率限制,检查 Graph 运行状况状态
故障排除:
交互式测试: Graph Explorer,网址:https://developer.microsoft.com/graph/graph-explorer
SDK:
Microsoft.Graph NuGet@microsoft/microsoft-graph-client npmmsgraph-sdk-python pip文档:
技能版本: 2.1 | API 版本: v1.0 (生产环境), beta (预览版) | 更新日期: 2025年12月
每周安装次数
111
代码仓库
GitHub 星标数
10
首次出现
2026年1月24日
安全审计
安装于
github-copilot100
opencode98
codex96
gemini-cli95
cursor90
kimi-cli85
Microsoft Graph is a unified REST API endpoint for accessing Microsoft Cloud resources across Microsoft 365, Windows, and Enterprise Mobility + Security. Base URL: https://graph.microsoft.com/{version}/{resource}
API Versions: v1.0 (production) or beta (preview)
Authentication: OAuth 2.0 via Azure AD
Data Format: JSON
| Task | Service | Load Resource |
|---|---|---|
| Setup auth, register apps, manage credentials | Applications & Auth | resources/authentication-apps.md |
| Manage users, groups, organization, directory | Identity & Access | resources/identity-access.md |
| Email, folders, attachments, rules, signatures | Mail Operations | resources/mail-operations.md |
| Calendar, events, scheduling, meetings, free/busy | Calendar & Scheduling | resources/calendar-scheduling.md |
| Upload files, folders, share, OneDrive, SharePoint | Files & Storage | resources/files-storage.md |
| Teams, channels, chats, presence, online meetings | Teams & Communications | resources/teams-communications.md |
| Planner tasks, To Do lists, OneNote notebooks | Planning & Notes | resources/planning-notes.md |
| Security alerts, compliance, device management, reports | Security & Governance | resources/security-governance.md |
Identify which service area you need by answering:
Use the decision table above to find your resource file. Each resource includes:
Each resource shows practical, copy-paste-ready examples for your use case.
Standard Query Parameters:
$select=prop1,prop2 Choose properties to return
$filter=startsWith(name,'A') Filter results by condition
$orderby=name desc Sort results (asc or desc)
$top=25 Limit to 25 results (default 20)
$skip=50 Skip first 50 results
$expand=members Include related/nested data
$count=true Include total count in response
$search="keyword" Full-text search across content
Standard CRUD Operations:
GET /me/messages?$select=subject&$top=10 # Read
POST /me/events {"subject": "Meeting", ...} # Create
PATCH /users/{id} {"jobTitle": "Manager"} # Update
DELETE /me/messages/{id} # Delete
Pagination: Always follow @odata.nextLink in responses for complete data sets
Batch Requests: Use POST /$batch to combine 1-20 operations into single call
Delta Queries: Use GET /users/delta to track changes since last query via @odata.deltaLink
Error Response Format:
{"error": {"code": "Code", "message": "Description"}}
Common Status Codes:
| File | Focus | Lines |
|---|---|---|
| authentication-apps.md | App registration, OAuth, credentials | 350+ |
| identity-access.md | Users, groups, organization, directory | 350+ |
| mail-operations.md | Email, folders, attachments, rules | 400+ |
| calendar-scheduling.md | Events, recurring, meetings, free/busy | 350+ |
| files-storage.md | OneDrive, SharePoint, uploads, sharing | 400+ |
| teams-communications.md |
Performance: Use $select for specific properties, implement pagination, cache tokens, use batch for bulk ops, apply delta queries for sync scenarios
Security: Store tokens securely (never in code), request least-privilege permissions, use managed identities for Azure, rotate credentials every 90 days, validate all responses
Development: Test in beta endpoint first, monitor deprecation notices, implement exponential backoff for retries, respect rate limiting, check Graph health status
Troubleshooting:
Interactive Testing: Graph Explorer at https://developer.microsoft.com/graph/graph-explorer
SDKs:
Microsoft.Graph NuGet@microsoft/microsoft-graph-client npmmsgraph-sdk-python pipDocumentation:
Skill Version: 2.1 | API Versions: v1.0 (production), beta (preview) | Updated: December 2025
Weekly Installs
111
Repository
GitHub Stars
10
First Seen
Jan 24, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
github-copilot100
opencode98
codex96
gemini-cli95
cursor90
kimi-cli85
Azure 升级评估与自动化工具 - 轻松迁移 Functions 计划、托管层级和 SKU
104,900 周安装
World-Fates 命运之轮:AI驱动的动态世界与角色命运管理工具 | 游戏设定生成器
118 周安装
AWS基础设施配置指南:EC2、VPC、负载均衡器、SSL证书一站式设置
118 周安装
落地页优化指南:提升转化率的核心原则、文案框架与设计模式
70 周安装
LangChain开发指南:Python构建LLM应用最佳实践与架构设计
119 周安装
专业合同审核AI工具 - Contract Review Pro | 律师法务合同审查助手,支持18类合同
121 周安装
OpenClaw专家技能clawpilot:AI代理安全配置、自动更新与核心架构指南
118 周安装
| Teams, channels, chats, presence |
| 350+ |
| planning-notes.md | Planner, To Do, OneNote | 350+ |
| security-governance.md | Security, compliance, devices, reports | 400+ |