SA
SkillAvatars
Back to MCP Tools

Apple Mail Mcp

data-ai MCP Server

🤖 MCP server for Apple Mail - Manage emails with AI using Claude Desktop. Search, send, organize mail with natural language.

bys-morgan-jeffries
VerifiedFreshInstall Ready
data-aidata-ai
5 views104 stars34 forksMIT
View on GitHubHomepageDocs

Why This Matters

Discovered via github-topic:mcp and last synced Today.

VerifiedFreshInstall Ready
Source
github-topic:mcp
Stars
104
Last synced
Today
Install
Instructions detected

Install

1. Install the package

uvx apple-mail-fast-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "apple-mail-mcp": {
      "command": "uvx",
      "args": [
        "apple-mail-fast-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

97
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (97)

read_emails

`get_emails(filter?, limit?)` + `get_email(message_id)`

APPLE_MAIL_READ_ONLY

`false`

APPLE_MAIL_INDEX_MAX_EMAILS

_unset_

Variable

Required

APPLE_MAIL_INDEX_EXCLUDE_MAILBOXES

`Drafts`

APPLE_MAIL_DEFAULT_ACCOUNT

First account

send_email

Not yet supported (planned)

APPLE_MAIL_INDEX_PATH

`~/.apple-mail-mcp/index.db`

APPLE_MAIL_DEFAULT_MAILBOX

`INBOX`

list_mailboxes

Folder hierarchy with message counts

create_rich_email_draft

Build a rich HTML `.eml` draft, open it in Mail, and optionally save it to Drafts

export_emails

Export single emails or mailboxes to TXT/HTML

Tool

Description

move_email

1 email

list_email_attachments

List attachments with names and sizes

Operation

Default Limit

manage_trash

5 emails

Issue

Fix

get_statistics

Email analytics (volume, top senders, read ratios)

list_accounts

List all configured Mail accounts

get_mailbox_unread_counts

Unread counts per mailbox or per-account summary

save_email_attachment

Save attachments to disk

manage_drafts

Create, list, send, and delete drafts

get_inbox_overview

Dashboard with unread counts, folders, and recent emails

list_inbox_emails

List emails with account/read-status filtering and optional content preview

update_email_status

10 emails

inbox_dashboard

Interactive UI dashboard (requires mcp-ui-server)

search_emails

Unified search — subject, sender, body text, dates, attachments, flag status/color, cross-account

compose_email

Send new emails (plain text or HTML body)

get_awaiting_reply

Find sent emails that haven't received a reply

get_email_thread

Conversation thread view

reply_to_email

Reply or reply-all with optional HTML body

create_mailbox

Create new mailboxes (supports nested paths)

forward_email

Forward with optional message, CC/BCC

get_top_senders

Analyse most frequent senders by count or domain

iCloud

`APPLE_MAIL_MCP_IMAP_PASSWORD_ICLOUD`

Feature

Description

Parameter

Type

query

string

from

string

subject

string

mailbox

string

account

string

isRead

boolean

isFlagged

boolean

dateFrom

string

dateTo

string

limit

number

id

string

preferHtml

boolean

offset

number

unreadOnly

boolean

to

string[]

body

string

cc

string[]

bcc

string[]

attachments

(string \

transport

`"applescript"` \

No

Up to 20 attachments: absolute file paths and/or inline `{filename, contentBase64}` objects

APPLE_MAIL_MCP_SMTP_PASSWORD

No

APPLE_MAIL_MCP_IMAP_KEYCHAIN_SERVICE

No

APPLE_MAIL_MCP_SMTP_HOST

Yes

APPLE_MAIL_MCP_IMAP_USER

Yes

APPLE_MAIL_MCP_IMAP_IDLE_MS

No

variables

object

ids

string[]

Limitation

Reason

APPLE_MAIL_MCP_SMTP_USER

Yes

APPLE_MAIL_MCP_IMAP_ACCOUNT

No

conditions

object[]

APPLE_MAIL_MCP_SMTP_PORT

No

APPLE_MAIL_MCP_IMAP_HOST

No

recipients

object[]

actions

object

APPLE_MAIL_MCP_SMTP_SECURE

No

APPLE_MAIL_MCP_IMAP_PORT

No

replyAll

boolean

oldName

string

matchAll

boolean

APPLE_MAIL_MCP_SMTP_FROM

No

APPLE_MAIL_MCP_IMAP_PASSWORD

No

send

boolean

newName

string

enabled

boolean

APPLE_MAIL_MCP_SMTP_KEYCHAIN_SERVICE

No

APPLE_MAIL_MCP_IMAP_KEYCHAIN_ACCOUNT

No

delayMs

number

name

string

APPLE_MAIL_MCP_SMTP_KEYCHAIN_ACCOUNT

No

APPLE_MAIL_MCP_IMAP_ACCOUNTS

No

Field

Type

savePath

string

APPLE_MAIL_MCP_IMAP_IDLE

No

email

string

attachmentName

string

Gmail

`APPLE_MAIL_MCP_IMAP_PASSWORD_GMAIL`

get_needs_response

Identify emails that likely need your response

Browse all MCP servers