mcp-outlook-applescript

A Model Context Protocol server for Microsoft Outlook on Mac. Access your mail, calendar, contacts, tasks, and notes through 49 MCP tools powered by AppleScript.

Features

• AppleScript backend — works with classic Outlook for Mac, no network or authentication required
• 49 tools — full coverage of mail, calendar, contacts, tasks, and notes
• Approval system — destructive operations (delete, move, junk) require a two-step prepare/confirm flow
• Zero native dependencies — pure TypeScript + AppleScript, no C++ compilation needed

Available Tools

Install

git clone https://github.com/hasan-imam/mcp-outlook-applescript.git
cd mcp-outlook-applescript
npm install && npm run build && npm pack && npm install -g mcp-outlook-applescript-*.tgz
cd .. && rm -rf mcp-outlook-applescript

This installs mcp-outlook-applescript as a global command. The checkout can be deleted after install.

To update, re-run the commands above.

Claude Code

claude mcp add outlook -- mcp-outlook-applescript

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "outlook": {
      "command": "mcp-outlook-applescript"
    }
  }
}

Requirements

• macOS with Microsoft Outlook (classic) installed and running
• Node.js >= 20
• Automation permission for Outlook (System Settings > Privacy & Security > Automation)

Development

npm install
npm run build      # compile TypeScript → dist/
npm run typecheck   # type-check without emitting
npm test            # 121 unit tests
bash scripts/audit.sh  # static quality audit (build, security, package, functional)

License

MIT — see LICENSE.