ms-graph-search

📁 pauljsnider/ai-config-guide 📅 2 days ago

总安装量

周安装量

#74932

全站排名

安装命令

npx skills add https://github.com/pauljsnider/ai-config-guide --skill ms-graph-search

Agent 安装分布

openclaw 2

gemini-cli 2

claude-code 2

github-copilot 2

codex 2

kimi-cli 2

Skill 文档

Microsoft Graph Search Skill

When asked to search OneDrive, Teams, Outlook, or other Microsoft 365 services, use curl commands to interact with Microsoft Graph API.

ð Security-First Design

ONE CRITICAL RULE: Claude NEVER displays your token back to you.

Simple workflow:

Claude opens Graph Explorer for you
You paste token in chat (it’s fine)
Claude uses it in curl commands but never echoes it back

Step 1: Get Access Token

Simple 3-Step Process:

Claude opens Graph Explorer (automatically)

# macOS: open "https://developer.microsoft.com/en-us/graph/graph-explorer"
# Linux: xdg-open "https://developer.microsoft.com/en-us/graph/graph-explorer"
# Windows: start "https://developer.microsoft.com/en-us/graph/graph-explorer"

You get token from browser:
- Sign in with your Microsoft account
- Click “Access token” tab (or profile icon)
- Copy the access token
- Paste it in chat (it’s fine to paste)
Claude uses it silently:
- Replaces TOKEN in curl commands
- Makes API calls
- Never displays it back

Token Notes:

Expires in 69-90 minutes, just get a new one when needed
Claude will store it for the session

Step 2: Search Using Graph API

Once you have the token, use these endpoints with curl:

Unified Search (Recommended)

Search across multiple services at once:

curl -X POST 'https://graph.microsoft.com/v1.0/search/query' \
  -H 'Authorization: Bearer TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "requests": [
      {
        "entityTypes": ["driveItem", "message", "chatMessage"],
        "query": {
          "queryString": "search terms here"
        },
        "from": 0,
        "size": 25
      }
    ]
  }'

Entity Types:

driveItem – OneDrive and SharePoint files
message – Outlook emails
chatMessage – Teams messages
event – Calendar events
person – People/contacts
list – SharePoint lists
listItem – SharePoint list items
site – SharePoint sites

OneDrive & SharePoint Files

Search files:

curl 'https://graph.microsoft.com/v1.0/me/drive/root/search(q='"'"'search terms'"'"')' \
  -H 'Authorization: Bearer TOKEN'

List files in OneDrive root:

curl 'https://graph.microsoft.com/v1.0/me/drive/root/children' \
  -H 'Authorization: Bearer TOKEN'

Files shared with me:

curl 'https://graph.microsoft.com/v1.0/me/drive/sharedWithMe' \
  -H 'Authorization: Bearer TOKEN'

Recent files:

curl 'https://graph.microsoft.com/v1.0/me/drive/recent' \
  -H 'Authorization: Bearer TOKEN'

Outlook Emails

Search emails:

curl 'https://graph.microsoft.com/v1.0/me/messages?$search="search terms"' \
  -H 'Authorization: Bearer TOKEN'

List inbox emails (top 10):

curl 'https://graph.microsoft.com/v1.0/me/messages?$top=10&$select=subject,from,receivedDateTime' \
  -H 'Authorization: Bearer TOKEN'

Filter by sender:

curl 'https://graph.microsoft.com/v1.0/me/messages?$filter=from/emailAddress/address eq '"'"'sender@example.com'"'"'' \
  -H 'Authorization: Bearer TOKEN'

Microsoft Teams

List my teams:

curl 'https://graph.microsoft.com/v1.0/me/joinedTeams' \
  -H 'Authorization: Bearer TOKEN'

Get team channels:

curl 'https://graph.microsoft.com/v1.0/teams/TEAM_ID/channels' \
  -H 'Authorization: Bearer TOKEN'

Get channel messages:

curl 'https://graph.microsoft.com/v1.0/teams/TEAM_ID/channels/CHANNEL_ID/messages' \
  -H 'Authorization: Bearer TOKEN'

My recent chats:

curl 'https://graph.microsoft.com/v1.0/me/chats' \
  -H 'Authorization: Bearer TOKEN'

Calendar

List calendar events:

curl 'https://graph.microsoft.com/v1.0/me/calendar/events' \
  -H 'Authorization: Bearer TOKEN'

Search events:

curl 'https://graph.microsoft.com/v1.0/me/events?$search="meeting topic"' \
  -H 'Authorization: Bearer TOKEN'

Query Parameters

Common query parameters:

$search="keywords" – Search with keywords
$filter=property eq 'value' – Filter results
$select=field1,field2 – Select specific fields
$top=N – Limit to N results
$orderby=field desc – Sort results
$skip=N – Skip N results (pagination)

Example Searches

“Find my recent Excel files”

curl 'https://graph.microsoft.com/v1.0/me/drive/root/search(q='"'"'.xlsx'"'"')' \
  -H 'Authorization: Bearer TOKEN'

“Search emails from John about budget”

curl 'https://graph.microsoft.com/v1.0/me/messages?$search="from:john budget"' \
  -H 'Authorization: Bearer TOKEN'

“Find files shared with me containing ‘proposal'”

curl -X POST 'https://graph.microsoft.com/v1.0/search/query' \
  -H 'Authorization: Bearer TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "requests": [{
      "entityTypes": ["driveItem"],
      "query": {"queryString": "proposal"},
      "from": 0,
      "size": 25
    }]
  }'

“Show my Teams messages mentioning ‘release'”

curl -X POST 'https://graph.microsoft.com/v1.0/search/query' \
  -H 'Authorization: Bearer TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "requests": [{
      "entityTypes": ["chatMessage"],
      "query": {"queryString": "release"},
      "from": 0,
      "size": 25
    }]
  }'

Response Handling

Graph API returns JSON. Use jq to parse if needed:

curl '...' | jq '.value[] | {name: .name, createdDateTime: .createdDateTime}'

Error Handling

Common errors:

401 Unauthorized: Token expired or invalid – get a new token
403 Forbidden: Missing permissions – user needs to grant consent in Graph Explorer
429 Too Many Requests: Rate limited – wait and retry
404 Not Found: Resource doesn’t exist
400 Bad Request: Invalid query syntax – check the API docs

When to Consult Documentation

Use WebFetch to look up documentation when:

Error occurs – Check error codes reference
Unsure about endpoint – Look up service-specific API docs
Query not working – Review query parameters guide
Permission denied – Check permissions reference
New requirement – Search for the specific API endpoint

Example:

# If you get a 403 error and aren't sure what permission is needed:
WebFetch "https://learn.microsoft.com/en-us/graph/permissions-reference"
  "What permissions are needed for searching OneDrive files?"

# If you need to find a specific endpoint:
WebFetch "https://learn.microsoft.com/en-us/graph/api/resources/driveitem"
  "How do I filter files by file type in OneDrive?"

Documentation & Reference

Use WebFetch to consult these docs when needed:

Permissions Required

The Graph Explorer token typically includes:

Files.Read.All – Read OneDrive files
Mail.Read – Read emails
Chat.Read – Read Teams chats
ChannelMessage.Read.All – Read Teams channels
Calendars.Read – Read calendar

If a request fails with 403, the user needs to consent to additional permissions in Graph Explorer.

Best Practices

Start with unified search (/search/query) for cross-service searches
Use specific endpoints for better performance when you know the service
Limit results with $top parameter (default is often 10)
Select only needed fields with $select to reduce response size
Handle pagination for large result sets using $skip and @odata.nextLink
Token security: Never echo or print the token – it grants access to user’s data

Output Format

Present results clearly:

ð OneDrive Search Results for "quarterly report"

Found 3 files:

1. Q4-2024-Report.xlsx
   Modified: 2024-12-15
   Path: /Documents/Reports
   ð [View in OneDrive]

2. Quarterly-Summary-Final.docx
   Modified: 2024-12-10
   Path: /Documents/Reports
   ð [View in OneDrive]

3. Q4-Presentation.pptx
   Modified: 2024-12-05
   Path: /Shared/Team Reports
   ð [View in OneDrive]

Common Queries

“Find my files in OneDrive”

â Open Graph Explorer, get token, use /me/drive/root/children or search endpoint

“Search my emails for X”

â Open Graph Explorer, get token, use /me/messages?$search="X"

“Show files shared with me”

â Open Graph Explorer, get token, use /me/drive/sharedWithMe

“Find Teams messages about X”

â Open Graph Explorer, get token, use unified search with chatMessage entity type

“What meetings do I have?”

â Open Graph Explorer, get token, use /me/calendar/events

Workflow Summary

When user asks to search Microsoft 365:

Open browser automatically to Graph Explorer
Wait for token from user (they paste it in chat)
Run curl commands replacing TOKEN with user’s token
Parse and present results in readable format
Handle errors (expired token = open browser again)
Use WebFetch to consult docs if you encounter issues

Important Notes

Token flow – You paste token in chat (it’s fine), Claude never displays it back
Token expires in 69-90 minutes – User will need to refresh if searches stop working
Rate limits apply – Microsoft Graph has throttling limits
Permissions vary – Some operations require admin consent
Beta endpoints exist but use /v1.0/ for stability
Search syntax varies by entity type – Some support KQL (Keyword Query Language)
Graph Explorer is great for testing – Users can try queries there first
Use WebFetch for docs – When stuck or encountering errors, look up relevant documentation
Documentation is comprehensive – Most issues can be resolved by checking the official Microsoft Learn docs

Last Updated: 2026-01-11

Security Notice: The ONE rule: Claude never displays your token back to you. Paste it in chat, Claude uses it silently in curl commands.

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台

ms-graph-search

Agent 安装分布

Skill 文档

Microsoft Graph Search Skill

ð Security-First Design

Step 1: Get Access Token

Step 2: Search Using Graph API

Unified Search (Recommended)

OneDrive & SharePoint Files

Outlook Emails

Microsoft Teams

Calendar

Query Parameters

Example Searches

“Find my recent Excel files”

“Search emails from John about budget”

“Find files shared with me containing ‘proposal'”

“Show my Teams messages mentioning ‘release'”

Response Handling

Error Handling

When to Consult Documentation

Documentation & Reference

Core Documentation

Search API

Service-Specific APIs

Troubleshooting

Query Parameters

Permissions Required

Best Practices

Output Format

Common Queries

“Find my files in OneDrive”

“Search my emails for X”

“Show files shared with me”

“Find Teams messages about X”

“What meetings do I have?”

Workflow Summary

Important Notes

ð Security-First Design