Outlook CLI for Openclaw

A professional CLI tool for managing Microsoft Outlook emails and calendar schedules via the Microsoft Graph API.

dongrebeccahhh-boop
v1.0.0
Mar 24, 2026
0
663
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install outlook-email-skill-fixed

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install outlook-email-skill-fixed using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Outlook CLI?

The Outlook CLI skill provides a comprehensive bridge between your AI agent and the Microsoft 365 ecosystem. By utilizing the Microsoft Graph API, this tool allows for seamless management of Outlook, Live.com, and Hotmail accounts. It is designed to be a core component of your Openclaw Skills library, enabling developers to build sophisticated automation workflows that involve reading, sending, and searching emails, as well as managing complex calendar schedules.

This skill is built with security in mind, employing OAuth 2.0 device code flows and local token encryption. Whether you are running an agent on a local machine or a headless server, this skill provides the necessary interface to interact with Microsoft communications without requiring a GUI.

Outlook CLI Use Cases

  • Automated inbox monitoring for specific triggers like invoices or project updates.
  • Seamless scheduling of team meetings and project reviews directly through the agent.
  • Sending multi-recipient emails with CC support and file-based message bodies.
  • Headless email management on remote servers where browser access is restricted.
  • Advanced searching of historical email data using specific Microsoft Graph operators.

How Outlook CLI Works

  1. Configuration: The user provides Azure AD application credentials to establish a verified connection with Microsoft services.
  2. Authentication: The skill uses the OAuth 2.0 device code flow to obtain secure access tokens, allowing for authentication on machines without a browser.
  3. Token Persistence: Tokens are stored locally with restrictive file permissions to ensure security while enabling automatic refreshes for long-term use.
  4. API Execution: Agent commands are converted into authenticated HTTPS requests to the Microsoft Graph API endpoints.
  5. Output Processing: The API results are parsed and presented in a clean, developer-friendly format for the agent to interpret or display.

Outlook CLI Setup

To integrate this into your collection of Openclaw Skills, follow these steps:

  1. Register an app in the Azure Portal (portal.azure.com) under App registrations.
  2. Set the platform to Public client/native and enable http://localhost:8080/callback as a redirect URI.
  3. Grant the following API permissions: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, and offline_access.
  4. Ensure Python 3 and the requests library are installed on your system.
  5. Run the configuration command:
outlook configure
  1. Perform the initial authentication using the device code flow:
outlook auth --device-code
  1. Secure your credential storage immediately:
chmod 600 ~/.config/outlook-cli/token.json

Outlook CLI Data Schema & Taxonomy

Component Storage Path Details
OAuth Tokens ~/.config/outlook-cli/token.json Stores sensitive access and refresh tokens.
Main Script ./outlook Python-based execution logic using requests.
Config File ~/.config/outlook-cli/config.json Stores Client ID and Tenant ID metadata.
API Schema Microsoft Graph All data follows the standard Microsoft Graph JSON response format.

Outlook CLI Advanced Features

  • Native support for Microsoft Graph API search syntax including attachment and date filters.
  • Automated token lifecycle management that background-refreshes tokens without user intervention.
  • Multi-recipient email support including CC and BCC fields via command-line arguments.
  • Robust calendar management allowing for duration-based scheduling and attendee invites.
  • Full compatibility with headless environments using the Microsoft device login verification process.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*