microsoft-skill

Microsoft Skill

A Claude Code plugin for Microsoft Graph API integration, focused on Outlook/Hotmail email access.

Installation

Add this plugin to Claude Code:

claude mcp add-plugin /path/to/microsoft-skill

Or add to your Claude Code configuration.

Features

• OAuth 2.0 Authentication with PKCE
• Email Operations: List messages, download as .eml
• Secure Storage: 1Password or local file credentials
• Per-project Tokens: Different Microsoft accounts per project

Quick Start

Once installed, the skill triggers when you ask about emails:

• "Check my outlook inbox"
• "Read my emails"
• "Download recent messages from hotmail"
• "List my microsoft mail"

First-time Setup

1. **Configure credentials**:

   pnpm tsx skills/microsoft-outlook/scripts/microsoft.ts setup

2. **Authenticate**:

   pnpm tsx skills/microsoft-outlook/scripts/microsoft.ts auth

3. **Verify**:

   pnpm tsx skills/microsoft-outlook/scripts/microsoft.ts me

Plugin Structure

microsoft-skill/
├── .claude-plugin/
│   └── plugin.json          # Plugin manifest
├── skills/
│   └── microsoft-outlook/
│       ├── SKILL.md         # Skill instructions
│       ├── scripts/         # CLI implementation
│       │   ├── microsoft.ts
│       │   └── lib/
│       └── references/      # Detailed documentation
│           ├── setup-guide.md
│           └── api-reference.md
├── package.json
└── README.md

Commands

Command	Description
setup	Configure API credentials
auth	Run OAuth flow
check	Verify auth status
me	Get user profile
messages	List recent messages
download	Download message as .eml
download-all	Download recent messages

Credential Setup

Register an app in [Microsoft Entra admin center](https://entra.microsoft.com/) or the [Azure Portal](https://portal.azure.com/):

...