mog

What This Skill Does

The mog (Microsoft Ops Gadget) skill is a powerful command-line interface tool integrated into OpenClaw for seamless interaction with the Microsoft 365 ecosystem. Designed as the Microsoft-centric counterpart to gog, it allows users to perform CRUD operations on Mail, Calendar, OneDrive, Contacts, Tasks, Word, PowerPoint, Excel, and OneNote. It abstracts complex Microsoft Graph API requests into human-readable, CLI-compliant commands. A standout feature is its slug system, which maps cumbersome 36-character Microsoft GUIDs into 8-character, easily referenced slugs, significantly simplifying file and item management workflows.

Installation

You can install this skill directly via the OpenClaw plugin manager by executing the command: clawhub install openclaw/skills/skills/visionik/mogcli. Upon installation, the skill requires initial authentication. It automatically creates a configuration directory at ~/.config/mog/ (or equivalent on Windows) where it stores encrypted OAuth tokens and metadata to ensure secure session persistence without requiring manual re-authentication for every task.

Use Cases

This skill is ideal for power users and developers who need to bridge the gap between their terminal environments and Microsoft 365.

• Automated Reporting: Use mog excel append to push logs or data directly into shared workbooks from your scripts.
• Task Management: Integrate terminal-based task tracking with Microsoft To-Do for synchronization across mobile and desktop devices.
• File Operations: Quickly search and retrieve files from OneDrive using short-form slugs instead of navigating the web browser interface.
• Calendar Coordination: Retrieve free/busy information for colleagues directly from the CLI to schedule meetings without switching contexts.

Example Prompts

1. "Use mog to find the most recent email from my manager and download any attached PDFs to the local directory."
2. "Can you check my calendar for tomorrow and add a meeting with Sarah at 2 PM using mog calendar?"
3. "Summarize the task list currently in my Microsoft Tasks using the mog tasks module and tell me what is due today."

Tips & Limitations

• Slug Utility: Always use the mog [command] list variants to generate and refresh your local slugs.json cache before referencing items by short ID.
• Security: Since this tool accesses sensitive personal data like emails and private files, ensure that the ~/.config/mog/ directory permissions remain restricted to your user account.
• Aliases: Leverage the built-in aliases mog cal and mog todo to save keystrokes during frequent operations.
• Limitations: While mog covers extensive functionality, complex document formatting in Word or high-level advanced Excel macro manipulation may still require the web interface or dedicated SDKs. Always run mog --ai-help for the latest documentation on unsupported edge cases.