aernouddekker avatar

Mailappmcp

aernouddekker/macos-mcp

Bridges Claude directly to macOS Mail.app via AppleScript, no OAuth or API keys required. Exposes 21 tools covering the full email lifecycle: search and read messages, compose drafts or send immediately, reply with threading, forward and redirect, manage attachments, move between mailboxes, flag and color messages, mark as junk, and trigger manual sync. Works with every account you've configured in Mail.app, whether that's iCloud, Gmail, Outlook, or Fastmail. Particularly useful if you want Claude to triage your inbox, draft replies in your voice, or automate email workflows without leaving your desktop or touching a web API.

tools
21
transport
STDIO
last updated
Sep 2, 2026

Tools

21 tools

Public tool metadata for what this MCP can expose to an agent.

list-mailboxesList all mailboxes across all accounts with unread counts

List all mailboxes across all accounts with unread counts

No parameter schema in public metadata yet.

list-accountsList configured mail accounts with email addresses and type

List configured mail accounts with email addresses and type

No parameter schema in public metadata yet.

list-signaturesList available email signatures

List available email signatures

No parameter schema in public metadata yet.

search-messagesSearch messages by subject or sender (empty query lists all)

Search messages by subject or sender (empty query lists all)

No parameter schema in public metadata yet.

read-messageRead the full content of a specific email

Read the full content of a specific email

No parameter schema in public metadata yet.

get-message-sourceGet raw RFC822 source of a message

Get raw RFC822 source of a message

No parameter schema in public metadata yet.

list-attachmentsList attachments on a message with name, MIME type, size

List attachments on a message with name, MIME type, size

No parameter schema in public metadata yet.

save-attachmentSave email attachments to disk

Save email attachments to disk

No parameter schema in public metadata yet.

compose-messageCreate a draft in Mail.app (does not send) — supports plain or HTML body via htmlBody, plus attachments

Create a draft in Mail.app (does not send) — supports plain or HTML body via htmlBody, plus attachments

No parameter schema in public metadata yet.

send-messageSend an email immediately (supports from, attachments, plain or HTML body via htmlBody)

Send an email immediately (supports from, attachments, plain or HTML body via htmlBody)

No parameter schema in public metadata yet.

reply-to-messageReply or reply-all to a message — threads correctly and supports a branded htmlBody or attachments

Reply or reply-all to a message — threads correctly and supports a branded htmlBody or attachments

No parameter schema in public metadata yet.

forward-messageForward a message to new recipients

Forward a message to new recipients

No parameter schema in public metadata yet.

redirect-messageRedirect a message (preserves original sender)

Redirect a message (preserves original sender)

No parameter schema in public metadata yet.

move-messagesMove messages between mailboxes

Move messages between mailboxes

No parameter schema in public metadata yet.

delete-messagesDelete messages by Message-ID

Delete messages by Message-ID

No parameter schema in public metadata yet.

mark-as-readMark messages as read

Mark messages as read

No parameter schema in public metadata yet.

mark-as-junkMark/unmark messages as junk

Mark/unmark messages as junk

No parameter schema in public metadata yet.

flag-messageFlag/unflag messages with color support

Flag/unflag messages with color support

No parameter schema in public metadata yet.

set-message-colorSet background color of messages in the message list

Set background color of messages in the message list

No parameter schema in public metadata yet.

check-for-new-mailTrigger a mail fetch for one or all accounts

Trigger a mail fetch for one or all accounts

No parameter schema in public metadata yet.

extract-email-addressParse "John Doe <jdoe@example.com>" into name and address

Parse "John Doe <jdoe@example.com>" into name and address

No parameter schema in public metadata yet.

Sponsors

Readme

macos-mcp

MCP servers for macOS native apps — gives Claude Code, Claude Desktop, and any MCP client native access to Mail, Numbers, Contacts, Calendar, Reminders, and FaceTime / phone calls.

No API keys, no OAuth, no cloud services. Talks directly to macOS apps via AppleScript and URL schemes (tel://, facetime://). Runs locally on your Mac.

CUPS printing (printmcp) used to live here; it moved to office-mcp since it's a shell wrapper, not an AppleScript bridge.

Servers

Mail (mailappmcp) — 21 tools

Works with every email account configured in Mail.app — iCloud, Gmail, Outlook, Fastmail, you name it.


View the full README on GitHub

Details

Repository
github.com/aernouddekker/macos-mcp
Categories
Communication & Messaging, Productivity & Office
Package
mailappmcp
Transport
STDIO
Registry
MCP registry, active

More from aernouddekker

Related Communication & Messaging MCP servers

View all
1pijusz avatarMcp Mailtrappijusz/mcp-mailtrapMCP server for the Mailtrap email platform — analytics, sending, contacts, sandbox3stars
2cnghockey avatarSats4AI - Bitcoin-Powered AI Toolscnghockey/sats4ai-mcp-server40+ Lightning-paid AI tools for agents: calls, SMS, fax, voice, translation. No signup, no keys.2stars
3creativestefan avatarMailbridgecreativestefan/mailbridge-mcpConnect your AI assistant to email — read, search, send, and organise via IMAP/SMTP.2stars
4platfone-com avatarPlatfoneplatfone-com/mcpVirtual phone numbers for AI agents — rent numbers in 200+ countries, receive SMS.0stars
5stonematt avatarMcp Obsidian Clistonematt/mcp-obsidian-cliSave chat notes from Claude Desktop to your vault — MCP on Obsidian CLI. Keep what matters.2stars
6adelaidasofia avatarMulti-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, tokenadelaidasofia/google-workspace-mcpMulti-account MCP for Gmail, Calendar, Drive, Docs, and Sheets — 61 tools, token-efficient, macOS…1stars