hasan-imam/mcp-outlook-applescript

10 stars 10 forks Quality 66 Trend 18MIT

MCP server for Microsoft Outlook on Mac — 49 tools for mail, calendar, contacts, tasks, and notes via AppleScript

Overview

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. - — works with classic Outlook for Mac, no network or authentication required - — full coverage of mail, calendar, contacts, tasks, and notes - — destructive operations (delete, move, junk) require a two-step prepare/confirm flow - — pure TypeScript + AppleScript, no C++ compilation needed This installs mcp-outlook-applescript as a global command. The checkout can be deleted after install. Add to ~/Library/Application Support/Claude/claude_desktop_config.json: - macOS with Microsoft Outlook (classic) installed and running - Node.js >= 20 - Automation permission for Outlook (System Settings > Privacy & Security > Automation)

README

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

Category	Tools
Mail	`list_folders`, `list_emails`, `search_emails`, `get_email`, `get_unread_count`, `send_email`, `list_attachments`, `download_attachment`
Mail Organization	`mark_email_read`, `mark_email_unread`, `set_email_flag`, `clear_email_flag`, `set_email_categories`, `prepare/confirm_delete_email`, `prepare/confirm_move_email`, `prepare/confirm_archive_email`, `prepare/confirm_junk_email`, `prepare/confirm_batch_*`
Folders	`create_folder`, `rename_folder`, `move_folder`, `prepare/confirm_delete_folder`, `prepare/confirm_empty_folder`
Calendar	`list_calendars`, `list_events`, `get_event`, `search_events`, `create_event`, `update_event`, `delete_event`, `respond_to_event`
Contacts	`list_contacts`, `search_contacts`, `get_contact`
Tasks	`list_tasks`, `search_tasks`, `get_task`
Notes	`list_notes`, `search_notes`, `get_note`
Accounts	`list_accounts`

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.

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

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