← Back to Skills Marketplace
Outlook Plus
by
Cristian Dan
· GitHub ↗
· v1.9.0
923
Downloads
0
Stars
1
Active Installs
6
Versions
Install in OpenClaw
/install outlook-plus
Description
Read, search, and manage Outlook emails and calendar via Microsoft Graph API. Use when the user asks about emails, inbox, Outlook, Microsoft mail, calendar e...
Usage Guidance
This skill appears to do what it says, but before installing or running it you should: 1) Review the scripts yourself (they will create an Azure App Registration and client secret in your Azure account). 2) Understand the requested scopes (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, offline_access) grant full read/write/send access to your mail and calendars — only proceed if you trust the author. 3) Be aware credentials and tokens are stored at ~/.outlook-mcp (files are chmod 600 in the scripts); do not share those files. 4) The token manager can print access tokens with outlook-token.sh get --confirm — avoid running that in insecure contexts. 5) Use a personal account or get admin approval if using a work account (organization consent may be required). 6) If you have concerns, run the setup steps manually following references/setup.md instead of automated script to retain full control.
Capability Analysis
Type: OpenClaw Skill
Name: outlook-plus
Version: 1.9.0
The skill is classified as suspicious due to its inherently high-risk capabilities, including the automatic creation of an Azure AD application with broad permissions (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite) as detailed in `SKILL.md` and implemented in `scripts/outlook-setup.sh`. It also stores sensitive OAuth tokens and client secrets locally in `~/.outlook-mcp/` and provides commands to download email attachments to the local filesystem via `scripts/outlook-mail.sh`. While the scripts demonstrate robust input sanitization (e.g., using `jq --arg` for JSON payloads, URL encoding, and filename sanitization in `scripts/outlook-mail.sh`) and transparency regarding permissions, the extensive access and control over a user's email and calendar, coupled with the ability to create Azure resources, represent significant potential for misuse if the agent were compromised or given malicious instructions.
Capability Assessment
Purpose & Capability
Name/description match the actual behavior: scripts call Microsoft Graph and the setup uses the Azure CLI to create an App Registration and obtain delegated OAuth tokens. Required binaries (az, jq) are necessary and used by the scripts.
Instruction Scope
Runtime instructions and scripts operate only against Microsoft endpoints (login.microsoftonline.com, graph.microsoft.com). They read/write config and tokens under ~/.outlook-mcp and optionally read system timezone files (/etc/timezone, /etc/localtime). Scripts accept OUTLOOK_ACCOUNT and OUTLOOK_TZ environment variables (used but not declared in requires.env). The token manager can print access tokens when run with explicit confirmation; this is flagged in the docs and scripts.
Install Mechanism
No install spec or external downloads — the package is instruction + shell scripts. No remote, arbitrary code download or extraction is performed by the skill itself.
Credentials
The skill requests OAuth permissions (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, offline_access) which are appropriate for full mail/calendar management. It requires Azure CLI login so it will create resources in the user's Azure account (App Registration and client secret) and stores client_id/client_secret and tokens in ~/.outlook-mcp. These sensitive artifacts are expected but merit careful handling by the user. The scripts also use optional env vars (OUTLOOK_ACCOUNT, OUTLOOK_TZ) that are not declared in the metadata.
Persistence & Privilege
always:false and user-invocable:true (normal). The skill writes credentials and tokens only under the invoking user's home (~/.outlook-mcp) and does not modify other skills or system-wide agent settings. It does create an App Registration in the user's Azure tenant during setup, which is expected for OAuth but is an action with side effects in the user's cloud account.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install outlook-plus - After installation, invoke the skill by name or use
/outlook-plus - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.9.0
Fixed --from filter to use $search. Removed changelog from SKILL.md.
v1.8.0
New query command with advanced filtering: date ranges (--after/--before), folder, sender, unread, attachments filters.
v1.7.0
Security: Fixed jq filter injection with --arg. Token get requires --confirm flag. URL-encode queries. Safe ID lookup helpers.
v1.6.0
Security: Fixed JSON injection - all user inputs now escaped via jq. Added warning to token get command.
v1.5.0
Added required binaries (az, jq) to metadata. Added credentials notice. Added Security Considerations section. Added homepage.
v1.4.0
Outlook Plus v1.4.0
- Added multi-account support: connect and manage multiple Outlook accounts (personal, work, etc.).
- New --account flag and OUTLOOK_ACCOUNT environment variable to select accounts for all commands.
- Added command to list configured accounts: outlook-token.sh list.
- Existing single-account setups are automatically migrated to the 'default' account name.
- Documentation significantly expanded with detailed usage, examples, and troubleshooting.
- No breaking changes for current users.
Metadata
Frequently Asked Questions
What is Outlook Plus?
Read, search, and manage Outlook emails and calendar via Microsoft Graph API. Use when the user asks about emails, inbox, Outlook, Microsoft mail, calendar e... It is an AI Agent Skill for Claude Code / OpenClaw, with 923 downloads so far.
How do I install Outlook Plus?
Run "/install outlook-plus" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Outlook Plus free?
Yes, Outlook Plus is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Outlook Plus support?
Outlook Plus is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Outlook Plus?
It is built and maintained by Cristian Dan (@cristiandan); the current version is v1.9.0.
More Skills