{
  "schemaVersion": "1.0",
  "item": {
    "slug": "outlook-plus",
    "name": "Outlook Plus",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/cristiandan/outlook-plus",
    "canonicalUrl": "https://clawhub.ai/cristiandan/outlook-plus",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/outlook-plus",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=outlook-plus",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "references/setup.md",
      "scripts/outlook-calendar.sh",
      "scripts/outlook-mail.sh",
      "scripts/outlook-setup.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/outlook-plus"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/outlook-plus",
    "agentPageUrl": "https://openagent3.xyz/skills/outlook-plus/agent",
    "manifestUrl": "https://openagent3.xyz/skills/outlook-plus/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/outlook-plus/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Outlook Skill",
        "body": "Access Outlook/Hotmail email and calendar via Microsoft Graph API using OAuth2."
      },
      {
        "title": "Quick Setup (Automated)",
        "body": "# Requires: Azure CLI, jq\n./scripts/outlook-setup.sh\n\nThe setup script will:\n\nLog you into Azure (device code flow)\nCreate an App Registration automatically\nConfigure API permissions (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite)\nGuide you through authorization\nSave credentials to ~/.outlook-mcp/"
      },
      {
        "title": "Manual Setup",
        "body": "See references/setup.md for step-by-step manual configuration via Azure Portal."
      },
      {
        "title": "Multiple Accounts",
        "body": "You can connect multiple Outlook accounts (personal, work, etc.):"
      },
      {
        "title": "Setup additional accounts",
        "body": "./scripts/outlook-setup.sh --account work\n./scripts/outlook-setup.sh --account personal"
      },
      {
        "title": "Use specific account",
        "body": "./scripts/outlook-mail.sh --account work inbox\n./scripts/outlook-calendar.sh --account personal today\n./scripts/outlook-token.sh --account work refresh"
      },
      {
        "title": "Or use environment variable",
        "body": "export OUTLOOK_ACCOUNT=work\n./scripts/outlook-mail.sh inbox"
      },
      {
        "title": "List configured accounts",
        "body": "./scripts/outlook-token.sh list\n\nCredentials are stored separately:\n\n~/.outlook-mcp/\n  default/\n    config.json\n    credentials.json\n  work/\n    config.json  \n    credentials.json\n\nExisting single-account setups are auto-migrated to default."
      },
      {
        "title": "Token Management",
        "body": "./scripts/outlook-token.sh refresh       # Refresh expired token\n./scripts/outlook-token.sh test          # Test connection\n./scripts/outlook-token.sh get --confirm # Print access token (requires confirmation)"
      },
      {
        "title": "Reading Emails",
        "body": "./scripts/outlook-mail.sh inbox [count]           # List latest emails (default: 10)\n./scripts/outlook-mail.sh unread [count]          # List unread emails\n./scripts/outlook-mail.sh search \"query\" [count]  # Search emails (KQL syntax)\n./scripts/outlook-mail.sh from <email> [count]    # List emails from sender\n./scripts/outlook-mail.sh read <id>               # Read email content\n./scripts/outlook-mail.sh attachments <id>        # List email attachments"
      },
      {
        "title": "Advanced Queries",
        "body": "# Date range filters\n./scripts/outlook-mail.sh query --after 2024-01-01 --before 2024-01-31\n\n# Folder + unread filter\n./scripts/outlook-mail.sh query --folder Inbox --unread --count 50\n\n# Sender + attachments filter\n./scripts/outlook-mail.sh query --from boss@work.com --has-attachments\n\n# Combined filters\n./scripts/outlook-mail.sh query --after 2024-06-01 --folder \"Sent Items\" --count 100\n\nQuery options:\n\n--after DATE — Emails received after date (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)\n--before DATE — Emails received before date\n--folder NAME — Search in specific folder\n--from EMAIL — Filter by sender email\n--unread — Only unread emails\n--has-attachments — Only emails with attachments\n--count N — Maximum results (default: 20)"
      },
      {
        "title": "Managing Emails",
        "body": "./scripts/outlook-mail.sh mark-read <id>          # Mark as read\n./scripts/outlook-mail.sh mark-unread <id>        # Mark as unread\n./scripts/outlook-mail.sh flag <id>               # Flag as important\n./scripts/outlook-mail.sh unflag <id>             # Remove flag\n./scripts/outlook-mail.sh delete <id>             # Move to trash\n./scripts/outlook-mail.sh archive <id>            # Move to archive\n./scripts/outlook-mail.sh move <id> <folder>      # Move to folder"
      },
      {
        "title": "Sending Emails",
        "body": "./scripts/outlook-mail.sh send <to> <subj> <body> # Send new email\n./scripts/outlook-mail.sh reply <id> \"body\"       # Reply to email"
      },
      {
        "title": "Folders & Stats",
        "body": "./scripts/outlook-mail.sh folders                 # List mail folders\n./scripts/outlook-mail.sh stats                   # Inbox statistics"
      },
      {
        "title": "Viewing Events",
        "body": "./scripts/outlook-calendar.sh events [count]      # List upcoming events\n./scripts/outlook-calendar.sh today               # Today's events\n./scripts/outlook-calendar.sh week                # This week's events\n./scripts/outlook-calendar.sh read <id>           # Event details\n./scripts/outlook-calendar.sh calendars           # List all calendars\n./scripts/outlook-calendar.sh free <start> <end>  # Check availability"
      },
      {
        "title": "Creating Events",
        "body": "./scripts/outlook-calendar.sh create <subj> <start> <end> [location]  # Create event\n./scripts/outlook-calendar.sh quick <subject> [time]                  # Quick 1-hour event"
      },
      {
        "title": "Managing Events",
        "body": "./scripts/outlook-calendar.sh update <id> <field> <value>  # Update (subject/location/start/end)\n./scripts/outlook-calendar.sh delete <id>                  # Delete event\n\nDate format: YYYY-MM-DDTHH:MM (e.g., 2026-01-26T10:00)"
      },
      {
        "title": "Example Output",
        "body": "$ ./scripts/outlook-mail.sh inbox 3\n\n{\n  \"n\": 1,\n  \"subject\": \"Your weekly digest\",\n  \"from\": \"digest@example.com\",\n  \"date\": \"2026-01-25T15:44\",\n  \"read\": false,\n  \"id\": \"icYY6QAIUE26PgAAAA==\"\n}\n{\n  \"n\": 2,\n  \"subject\": \"Meeting reminder\",\n  \"from\": \"calendar@outlook.com\",\n  \"date\": \"2026-01-25T14:06\",\n  \"read\": true,\n  \"id\": \"icYY6QAIUE26PQAAAA==\"\n}\n\n$ ./scripts/outlook-mail.sh read \"icYY6QAIUE26PgAAAA==\"\n\n{\n  \"subject\": \"Your weekly digest\",\n  \"from\": { \"name\": \"Digest\", \"address\": \"digest@example.com\" },\n  \"to\": [\"you@hotmail.com\"],\n  \"date\": \"2026-01-25T15:44:00Z\",\n  \"body\": \"Here's what happened this week...\"\n}\n\n$ ./scripts/outlook-mail.sh stats\n\n{\n  \"folder\": \"Inbox\",\n  \"total\": 14098,\n  \"unread\": 2955\n}\n\n$ ./scripts/outlook-calendar.sh today\n\n{\n  \"n\": 1,\n  \"subject\": \"Team standup\",\n  \"start\": \"2026-01-25T10:00\",\n  \"end\": \"2026-01-25T10:30\",\n  \"location\": \"Teams\",\n  \"id\": \"AAMkAGQ5NzE4YjQ3...\"\n}\n\n$ ./scripts/outlook-calendar.sh create \"Lunch with client\" \"2026-01-26T13:00\" \"2026-01-26T14:00\" \"Restaurant\"\n\n{\n  \"status\": \"event created\",\n  \"subject\": \"Lunch with client\",\n  \"start\": \"2026-01-26T13:00\",\n  \"end\": \"2026-01-26T14:00\",\n  \"id\": \"AAMkAGQ5NzE4YjQ3...\"\n}"
      },
      {
        "title": "Token Refresh",
        "body": "Access tokens expire after ~1 hour. Refresh with:\n\n./scripts/outlook-token.sh refresh"
      },
      {
        "title": "Files",
        "body": "~/.outlook-mcp/config.json - Client ID and secret\n~/.outlook-mcp/credentials.json - OAuth tokens (access + refresh)"
      },
      {
        "title": "Permissions",
        "body": "Mail.ReadWrite - Read and modify emails\nMail.Send - Send emails\nCalendars.ReadWrite - Read and modify calendar events\noffline_access - Refresh tokens (stay logged in)\nUser.Read - Basic profile info"
      },
      {
        "title": "Notes",
        "body": "Email IDs: The id field shows the last 20 characters of the full message ID. Use this ID with commands like read, mark-read, delete, etc.\nNumbered results: Emails are numbered (n: 1, 2, 3...) for easy reference in conversation.\nText extraction: HTML email bodies are automatically converted to plain text.\nToken expiry: Access tokens expire after ~1 hour. Run outlook-token.sh refresh when you see auth errors.\nRecent emails: Commands like read, mark-read, etc. search the 100 most recent emails for the ID."
      },
      {
        "title": "Troubleshooting",
        "body": "\"Token expired\" → Run outlook-token.sh refresh\n\n\"Invalid grant\" → Token invalid, re-run setup: outlook-setup.sh\n\n\"Insufficient privileges\" → Check app permissions in Azure Portal → API Permissions\n\n\"Message not found\" → The email may be older than 100 messages. Use search to find it first.\n\n\"Folder not found\" → Use exact folder name. Run folders to see available folders."
      },
      {
        "title": "Supported Accounts",
        "body": "Personal Microsoft accounts (outlook.com, hotmail.com, live.com)\nWork/School accounts (Microsoft 365) - may require admin consent"
      },
      {
        "title": "Security Considerations",
        "body": "Azure App Registration: The automated setup creates an App Registration in your Azure tenant with the following permissions: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, offline_access, User.Read\nLocal credential storage: Client ID, client secret, and OAuth tokens are stored in ~/.outlook-mcp/ with chmod 600\nToken printing: outlook-token.sh get --confirm prints access tokens (requires explicit confirmation flag)\nPrerequisites: Requires Azure CLI (az) and jq\n\nIf you prefer not to use automated setup, follow the manual configuration in references/setup.md."
      }
    ],
    "body": "Outlook Skill\n\nAccess Outlook/Hotmail email and calendar via Microsoft Graph API using OAuth2.\n\nQuick Setup (Automated)\n# Requires: Azure CLI, jq\n./scripts/outlook-setup.sh\n\n\nThe setup script will:\n\nLog you into Azure (device code flow)\nCreate an App Registration automatically\nConfigure API permissions (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite)\nGuide you through authorization\nSave credentials to ~/.outlook-mcp/\nManual Setup\n\nSee references/setup.md for step-by-step manual configuration via Azure Portal.\n\nMultiple Accounts\n\nYou can connect multiple Outlook accounts (personal, work, etc.):\n\nSetup additional accounts\n./scripts/outlook-setup.sh --account work\n./scripts/outlook-setup.sh --account personal\n\nUse specific account\n./scripts/outlook-mail.sh --account work inbox\n./scripts/outlook-calendar.sh --account personal today\n./scripts/outlook-token.sh --account work refresh\n\nOr use environment variable\nexport OUTLOOK_ACCOUNT=work\n./scripts/outlook-mail.sh inbox\n\nList configured accounts\n./scripts/outlook-token.sh list\n\n\nCredentials are stored separately:\n\n~/.outlook-mcp/\n  default/\n    config.json\n    credentials.json\n  work/\n    config.json  \n    credentials.json\n\n\nExisting single-account setups are auto-migrated to default.\n\nUsage\nToken Management\n./scripts/outlook-token.sh refresh       # Refresh expired token\n./scripts/outlook-token.sh test          # Test connection\n./scripts/outlook-token.sh get --confirm # Print access token (requires confirmation)\n\nReading Emails\n./scripts/outlook-mail.sh inbox [count]           # List latest emails (default: 10)\n./scripts/outlook-mail.sh unread [count]          # List unread emails\n./scripts/outlook-mail.sh search \"query\" [count]  # Search emails (KQL syntax)\n./scripts/outlook-mail.sh from <email> [count]    # List emails from sender\n./scripts/outlook-mail.sh read <id>               # Read email content\n./scripts/outlook-mail.sh attachments <id>        # List email attachments\n\nAdvanced Queries\n# Date range filters\n./scripts/outlook-mail.sh query --after 2024-01-01 --before 2024-01-31\n\n# Folder + unread filter\n./scripts/outlook-mail.sh query --folder Inbox --unread --count 50\n\n# Sender + attachments filter\n./scripts/outlook-mail.sh query --from boss@work.com --has-attachments\n\n# Combined filters\n./scripts/outlook-mail.sh query --after 2024-06-01 --folder \"Sent Items\" --count 100\n\n\nQuery options:\n\n--after DATE — Emails received after date (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS)\n--before DATE — Emails received before date\n--folder NAME — Search in specific folder\n--from EMAIL — Filter by sender email\n--unread — Only unread emails\n--has-attachments — Only emails with attachments\n--count N — Maximum results (default: 20)\nManaging Emails\n./scripts/outlook-mail.sh mark-read <id>          # Mark as read\n./scripts/outlook-mail.sh mark-unread <id>        # Mark as unread\n./scripts/outlook-mail.sh flag <id>               # Flag as important\n./scripts/outlook-mail.sh unflag <id>             # Remove flag\n./scripts/outlook-mail.sh delete <id>             # Move to trash\n./scripts/outlook-mail.sh archive <id>            # Move to archive\n./scripts/outlook-mail.sh move <id> <folder>      # Move to folder\n\nSending Emails\n./scripts/outlook-mail.sh send <to> <subj> <body> # Send new email\n./scripts/outlook-mail.sh reply <id> \"body\"       # Reply to email\n\nFolders & Stats\n./scripts/outlook-mail.sh folders                 # List mail folders\n./scripts/outlook-mail.sh stats                   # Inbox statistics\n\nCalendar\nViewing Events\n./scripts/outlook-calendar.sh events [count]      # List upcoming events\n./scripts/outlook-calendar.sh today               # Today's events\n./scripts/outlook-calendar.sh week                # This week's events\n./scripts/outlook-calendar.sh read <id>           # Event details\n./scripts/outlook-calendar.sh calendars           # List all calendars\n./scripts/outlook-calendar.sh free <start> <end>  # Check availability\n\nCreating Events\n./scripts/outlook-calendar.sh create <subj> <start> <end> [location]  # Create event\n./scripts/outlook-calendar.sh quick <subject> [time]                  # Quick 1-hour event\n\nManaging Events\n./scripts/outlook-calendar.sh update <id> <field> <value>  # Update (subject/location/start/end)\n./scripts/outlook-calendar.sh delete <id>                  # Delete event\n\n\nDate format: YYYY-MM-DDTHH:MM (e.g., 2026-01-26T10:00)\n\nExample Output\n$ ./scripts/outlook-mail.sh inbox 3\n\n{\n  \"n\": 1,\n  \"subject\": \"Your weekly digest\",\n  \"from\": \"digest@example.com\",\n  \"date\": \"2026-01-25T15:44\",\n  \"read\": false,\n  \"id\": \"icYY6QAIUE26PgAAAA==\"\n}\n{\n  \"n\": 2,\n  \"subject\": \"Meeting reminder\",\n  \"from\": \"calendar@outlook.com\",\n  \"date\": \"2026-01-25T14:06\",\n  \"read\": true,\n  \"id\": \"icYY6QAIUE26PQAAAA==\"\n}\n\n$ ./scripts/outlook-mail.sh read \"icYY6QAIUE26PgAAAA==\"\n\n{\n  \"subject\": \"Your weekly digest\",\n  \"from\": { \"name\": \"Digest\", \"address\": \"digest@example.com\" },\n  \"to\": [\"you@hotmail.com\"],\n  \"date\": \"2026-01-25T15:44:00Z\",\n  \"body\": \"Here's what happened this week...\"\n}\n\n$ ./scripts/outlook-mail.sh stats\n\n{\n  \"folder\": \"Inbox\",\n  \"total\": 14098,\n  \"unread\": 2955\n}\n\n$ ./scripts/outlook-calendar.sh today\n\n{\n  \"n\": 1,\n  \"subject\": \"Team standup\",\n  \"start\": \"2026-01-25T10:00\",\n  \"end\": \"2026-01-25T10:30\",\n  \"location\": \"Teams\",\n  \"id\": \"AAMkAGQ5NzE4YjQ3...\"\n}\n\n$ ./scripts/outlook-calendar.sh create \"Lunch with client\" \"2026-01-26T13:00\" \"2026-01-26T14:00\" \"Restaurant\"\n\n{\n  \"status\": \"event created\",\n  \"subject\": \"Lunch with client\",\n  \"start\": \"2026-01-26T13:00\",\n  \"end\": \"2026-01-26T14:00\",\n  \"id\": \"AAMkAGQ5NzE4YjQ3...\"\n}\n\nToken Refresh\n\nAccess tokens expire after ~1 hour. Refresh with:\n\n./scripts/outlook-token.sh refresh\n\nFiles\n~/.outlook-mcp/config.json - Client ID and secret\n~/.outlook-mcp/credentials.json - OAuth tokens (access + refresh)\nPermissions\nMail.ReadWrite - Read and modify emails\nMail.Send - Send emails\nCalendars.ReadWrite - Read and modify calendar events\noffline_access - Refresh tokens (stay logged in)\nUser.Read - Basic profile info\nNotes\nEmail IDs: The id field shows the last 20 characters of the full message ID. Use this ID with commands like read, mark-read, delete, etc.\nNumbered results: Emails are numbered (n: 1, 2, 3...) for easy reference in conversation.\nText extraction: HTML email bodies are automatically converted to plain text.\nToken expiry: Access tokens expire after ~1 hour. Run outlook-token.sh refresh when you see auth errors.\nRecent emails: Commands like read, mark-read, etc. search the 100 most recent emails for the ID.\nTroubleshooting\n\n\"Token expired\" → Run outlook-token.sh refresh\n\n\"Invalid grant\" → Token invalid, re-run setup: outlook-setup.sh\n\n\"Insufficient privileges\" → Check app permissions in Azure Portal → API Permissions\n\n\"Message not found\" → The email may be older than 100 messages. Use search to find it first.\n\n\"Folder not found\" → Use exact folder name. Run folders to see available folders.\n\nSupported Accounts\nPersonal Microsoft accounts (outlook.com, hotmail.com, live.com)\nWork/School accounts (Microsoft 365) - may require admin consent\nSecurity Considerations\nAzure App Registration: The automated setup creates an App Registration in your Azure tenant with the following permissions: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, offline_access, User.Read\nLocal credential storage: Client ID, client secret, and OAuth tokens are stored in ~/.outlook-mcp/ with chmod 600\nToken printing: outlook-token.sh get --confirm prints access tokens (requires explicit confirmation flag)\nPrerequisites: Requires Azure CLI (az) and jq\n\nIf you prefer not to use automated setup, follow the manual configuration in references/setup.md."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/cristiandan/outlook-plus",
    "publisherUrl": "https://clawhub.ai/cristiandan/outlook-plus",
    "owner": "cristiandan",
    "version": "1.9.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/outlook-plus",
    "downloadUrl": "https://openagent3.xyz/downloads/outlook-plus",
    "agentUrl": "https://openagent3.xyz/skills/outlook-plus/agent",
    "manifestUrl": "https://openagent3.xyz/skills/outlook-plus/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/outlook-plus/agent.md"
  }
}