使用说明
Apple Outlook MCP Server
An MCP server for managing Exchange/Outlook accounts in Apple Mail on macOS.
Features
- Read emails - Search, view messages, and list attachments
- Draft workflow - Create drafts, replies, forwards, then send when ready
- Delete emails - Move messages to Deleted Items
- Local-first - Uses Apple Mail's existing authentication, no OAuth setup required
Setup
Prerequisites
- Apple Mail configured with an Exchange/Outlook account
- macOS (uses AppleScript to control Mail.app)
Configure Claude Desktop
Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"apple-outlook": {
"command": "uvx",
"args": ["--from", "git+https://github.com/olivernormand/apple-outlook-mcp", "apple-outlook-mcp"]
}
}
}
Available Tools
Read
| Tool | Description |
|---|---|
list_mailboxes |
List mailboxes for an account |
search_messages |
Search with filters (sender, subject, read status) |
get_message |
Get full message details and content |
get_attachments |
List attachments on a message |
Draft
| Tool | Description |
|---|---|
create_draft |
Create a new email draft |
create_reply_draft |
Create a reply to a message |
create_forward_draft |
Create a forward of a message |
send_draft |
Send a draft by ID |
Delete
| Tool | Description |
|---|---|
delete_messages |
Move messages to Deleted Items |
Architecture
- Local-first: All operations run locally via AppleScript
- No OAuth: Uses Apple Mail's existing account authentication
- Draft workflow: Emails open in compose windows for review before sending
- Exchange-optimized: Uses Exchange mailbox naming (Inbox, Sent Items, Deleted Items)
The server communicates with Mail.app via AppleScript (osascript). Your credentials stay in Apple Mail - this server never handles authentication directly.
Local Development
git clone https://github.com/onormand/apple-outlook-mcp
cd apple-outlook-mcp
uv sync
uv run apple-outlook-mcp
Acknowledgments
This project evolved from apple-mail-mcp by Scott Morgan-Jeffries.
License
MIT
