← Back to Skills Marketplace
Outlook Mcp
by
Michael Palermiti
· GitHub ↗
· v1.4.1
· MIT-0
169
Downloads
1
Stars
0
Active Installs
7
Versions
Install in OpenClaw
/install outlook-mcp
Description
MCP server for Microsoft Outlook personal accounts. 52 tools — mail, calendar, contacts, to-do, drafts, attachments, folders, threading, batch ops, Focused I...
Usage Guidance
This skill is coherent with its stated purpose, but it grants an agent full programmatic access to your personal Outlook account when you configure read-write scopes. Before installing: (1) Confirm you trust the upstream repository (https://github.com/mpalermiti/outlook-mcp) because the install clones and installs code. (2) Use BYOID: register your own Azure AD app and supply only your client_id; do not reuse a public/shared client_id. (3) Start with read_only: true to limit write operations while you test. (4) Be aware tokens are saved in the OS keyring and an auth_record is written to ~/.outlook-mcp — protect that directory and the account used for auth. (5) The install step will change your system (install packages via uv/pip); inspect the repo or run in an isolated environment if you want to audit first. Note: the registry metadata shown at the top said “no install spec / instruction-only,” but SKILL.md contains an install command and the archive includes full source — that mismatch is benign here but worth noticing.
Capability Tags
Capability Assessment
Purpose & Capability
Name, description, and included source files match: this is an MCP server that uses Microsoft Graph and requires a user-registered Azure AD app (client_id) and device-code auth. The requested operations (mail, calendar, contacts, tasks, attachments, folder ops, batching) align with the described capabilities.
Instruction Scope
Runtime instructions are explicit and scoped: they ask you to create ~/.outlook-mcp/config.json with your Azure client_id, run a CLI device-code auth on the host, and register the MCP server with OpenClaw (which writes to ~/.openclaw/openclaw.json). The instructions require granting Microsoft Graph scopes (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, Contacts.ReadWrite, Tasks.ReadWrite) — expected for full read/write access, but this is powerful and worth confirming you want an AI agent to have it. The SKILL.md's privacy claims (only contacting login.microsoftonline.com and graph.microsoft.com, storing tokens in OS keyring) are consistent with the code.
Install Mechanism
The SKILL.md includes an install step that clones the GitHub repo and runs 'uv sync' (a package manager step). The code bundle is included in the skill. Cloning from github.com/mpalermiti/outlook-mcp is a standard release source; the install will pull and install Python dependencies. This is normal for this type of project, but it does execute an install step that writes files and installs packages on the host.
Credentials
The skill requests no unrelated environment variables or external credentials. It requires you to supply an Azure AD client_id in a local config (BYOID) and to run an interactive device-code login that stores tokens in the OS keyring and an authentication record in ~/.outlook-mcp/auth_record.json. Those are proportional to an Outlook Graph integration.
Persistence & Privilege
The skill is not force-included (always:false). It persists its own config under ~/.outlook-mcp and the MCP registration writes to the user's OpenClaw config (~/.openclaw/openclaw.json) — both are expected and scoped to the skill. It does not request global system privileges or modify other skills' configs beyond registering itself with the MCP client.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install outlook-mcp - After installation, invoke the skill by name or use
/outlook-mcp - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.4.1
Fix: paginate child_folders calls so folders with >10 subfolders are fully returned
v1.4.0
Recursive folder tree listing + subfolder name resolution for move/copy/batch_triage
v1.3.1
Perf: batch_triage now uses Graph /$batch — one round-trip per batch instead of N sequential calls. 10-20× faster for multi-message triage.
v1.3.0
Folder references now accept display names transparently — 'Junk Email', 'TLDR', 'Sent Items' etc. resolve to Graph IDs inside the MCP, so callers skip the list_folders detour.
v1.2.0
- Added Focused Inbox support: new "outlook_reclassify_message" tool for moving messages between Focused and Other.
- Tool count increased from 51 to 52.
- Documentation updated to reflect the new tool and Focused Inbox capability.
- Minor internal code and test updates to support the new feature.
v1.1.0
- Adds granular permission control with new `allow_categories` config option; restrict tools by category (e.g. allow only calendar writes).
- Introduces new `permissions.py` module and test coverage for permissions.
- Improves config, validation, and internal error handling to support per-category enforcement.
- Updates documentation and examples to explain permission categories and fine-grained policy setup.
- Removes obsolete planning docs.
v1.0.0
- Initial release of outlook-mcp MCP server for Microsoft Outlook personal accounts.
- Provides 51 tools for mail, calendar, contacts, to-do, drafts, attachments, folders, threading, and batch operations via Microsoft Graph API.
- Supports only personal Microsoft accounts (`@outlook.com`, `@hotmail.com`, `@live.com`), not work/school accounts.
- Requires Azure AD app registration and CLI-based authentication on the host.
- Zero telemetry, no local caching; tokens stored securely in OS keyring.
- Open-source and independent; not affiliated with Microsoft.
Metadata
Frequently Asked Questions
What is Outlook Mcp?
MCP server for Microsoft Outlook personal accounts. 52 tools — mail, calendar, contacts, to-do, drafts, attachments, folders, threading, batch ops, Focused I... It is an AI Agent Skill for Claude Code / OpenClaw, with 169 downloads so far.
How do I install Outlook Mcp?
Run "/install outlook-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Outlook Mcp free?
Yes, Outlook Mcp is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Outlook Mcp support?
Outlook Mcp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Outlook Mcp?
It is built and maintained by Michael Palermiti (@mpalermiti); the current version is v1.4.1.
More Skills