Resources · Claude connector

Claude Airmail connectorWhat Claude can do in your Airmail account.

The Claude Airmail connector exposes 102 tools. 45 read mail, calendar and contacts, 50 change something, 7 are left unclassified. Below: what Claude can do in Airmail on your Mac, which tools send at once, and how to cut access.

Verified Trustpilot reviews · AI, automation & growth agency

Overview

What changes for your inbox

Airmail's connector is a local extension for Claude Desktop that talks to the Airmail app on your Mac. Instead of clicking through folders, you ask Claude to summarize what came in, file the noise, draft replies or book a meeting. It reaches mail, calendar, reminders and contacts, and the tool list is one of the longest in the directory.

Clear a crowded inbox in minutes. batch_triage_inbox suggests an action and a priority for each message, then archive_messages or move_messages apply the ones you keep.

Answer without losing control. reply_to_message and compose_email open a pre-filled window and leave the send button to you. Airmail's own example asks for a reply that is opened but not sent.

Keep the calendar and contacts in step. create_event, create_reminder and update_contact turn what an email says into a meeting, a follow-up or a corrected card.

What to watch: two tools skip the window. quick_reply and send_email send immediately, and several deletions are permanent. Nothing runs on its own either: Claude acts only while you talk to it, and only while Airmail is open on this Mac. And Claude never reaches mail on another computer. For email marketing rather than a personal inbox, see the Claude activecampaign connector.

Vocabulary

The vocabulary in one minute

Five words you will meet while plugging Airmail in.

Connector
The link you set up once between Claude and an account you already have, so Claude can work in it while it answers you.
Tool
One named action the connector opens to Claude. Claude picks the ones it needs on its own; the directory lists them by name.
Authorization
The permission you grant so Claude can act. With Airmail, it is a pairing prompt in the app itself, revocable client by client.
Approval
The confirmation Claude waits for before it finishes an action that changes your account, shown right in the conversation.
MCP
The shared standard connectors are built on: it is what lets an assistant like Claude talk to an outside app such as Airmail.
Connect

Connect Airmail to Claude in three steps

  1. 01

    Find Airmail in Claude Desktop

    In Claude Desktop's settings, open Customize, then Connectors, and look for Airmail in the list. On a Team or Enterprise workspace, an Owner or Primary Owner has to enable it first before members can add it.

  2. 02

    Start the connection

    Click Connect on its row to add the extension to Claude Desktop on your Mac. If it misbehaves later, use Disconnect and add it again from the same row.

  3. 03

    Approve the pairing in Airmail

    On first use, Airmail itself shows an authorization prompt: click Allow. That prompt belongs to Airmail, not to Claude, and the access it grants can be revoked later, client by client, in Airmail's MCP Permissions tab.

Tools

The 102 Claude Airmail connector tools, sorted by what they do

Airmail gives Claude 102 tools: 45 that read your account, 50 that change something in it, and 7 no official source describes.

Three groups: what Claude reads, what it changes, and what the sources leave unclassified. Names stay exactly as Claude shows them.

  • 45 read
  • 50 write
  • 7 not documented

What Claude reads (45)

45 tools

Forty-five tools that look at mail, calendar, contacts and settings without touching them.

get_account_settings

Reads the settings of one mail account, as Airmail stores them.

When it helps
a signature or server option behaves oddly on one address and you want to see its setup.
Watch out
it reads one account at a time.

Sourcegithub.com · September 30, 2026 ↗

get_vacation_settings

Reads the out-of-office auto-reply settings of an account, so you know whether a vacation message is active and what it says.

When it helps
you are back from leave and want to confirm the automatic reply is no longer going out.
Watch out
it reads the setting only; switching it off is the set tool.

Sourcegithub.com · September 30, 2026 ↗

list_aliases

Shows the email aliases set up on your accounts, the extra addresses that land in the same mailbox.

When it helps
you want to know which alias the support form replies should come from.
Watch out
aliases are per account; name the account if you have several.

Sourcegithub.com · September 30, 2026 ↗

list_calendars

Lists your calendars with their IDs, titles and types, so Claude knows which one holds work events and which one family plans.

When it helps
you keep a shared team calendar and a private one and want events looked up in the right place.
Watch out
it covers calendars Airmail can see on this Mac.

Sourcegithub.com · September 30, 2026 ↗

list_events

Lists events over a date range, the next seven days when you do not say otherwise.

When it helps
you want a read of next week before promising a client a meeting slot.
Watch out
past the default week, give Claude the dates you have in mind.

Sourcegithub.com · September 30, 2026 ↗

get_event

Opens one event with its attendees, alarms, recurrence and notes.

When it helps
a recurring review lost its agenda and you want to see who is invited and what the notes say.
Watch out
it only reads; adjusting the time or guests is a separate tool's job.

Sourcegithub.com · September 30, 2026 ↗

list_reminders

Lists your reminders so Claude can tell you what you promised yourself to do, and by when.

When it helps
you want everything due this week before planning Monday.
Watch out
only reminders Airmail can reach on this Mac appear here.

Sourcegithub.com · September 30, 2026 ↗

list_drafts

Lists the drafts waiting in your accounts, so nothing half-written slips through.

When it helps
you suspect three replies are sitting unfinished since Tuesday.
Watch out
it lists drafts across all accounts; reading one in full takes the draft tool.

Sourcegithub.com · September 30, 2026 ↗

list_contacts_book

Lists the contacts stored in your address book, the people you saved rather than just those who wrote.

When it helps
you want every contact tagged with a partner company before a joint event.
Watch out
correspondents you never saved are not in it; search_contacts covers recent senders.

Sourcegithub.com · September 30, 2026 ↗

get_contact

Opens one contact with all its details, from phone numbers to postal address.

When it helps
you need a supplier's direct line and it is only in the address book.
Watch out
it shows what the card holds; missing fields stay missing.

Sourcegithub.com · September 30, 2026 ↗

search_contacts_book

Searches saved contacts by name or email, inside the address book only.

When it helps
you want the card of the accountant whose surname you half remember.
Watch out
senders you never saved will not show; use the sender search for those.

Sourcegithub.com · September 30, 2026 ↗

list_contact_groups

Lists the groups your contacts are organized in, such as a board, a client team or a family list.

When it helps
you want to know which group to address before inviting the steering committee.
Watch out
it lists groups, not their members one by one.

Sourcegithub.com · September 30, 2026 ↗

list_vips

Lists the senders you marked as VIP, the people whose mail should never wait.

When it helps
you want to check that your two biggest clients are on the list after a reinstall.
Watch out
it only reads the list; adding someone takes another tool in the list.

Sourcegithub.com · September 30, 2026 ↗

list_blocked

Shows the senders you blocked, so Claude can tell whether a missing email was stopped on purpose.

When it helps
a partner complains you never answer and you want to rule out an old block.
Watch out
reading the list unblocks no one; the unblock tool handles that.

Sourcegithub.com · September 30, 2026 ↗

get_preferences

Reads Airmail's app preferences, the settings that shape how the client behaves on your Mac.

When it helps
a behavior changed after a new version and you want to see what the setting currently says.
Watch out
it reads the settings only; set_preferences is its counterpart.

Sourcegithub.com · September 30, 2026 ↗

batch_triage_inbox

Returns inbox messages with a suggested next step for each, from answering to deferring, and a priority score.

When it helps
fifty unread messages after a conference and you want to know which five deserve a reply today.
Watch out
it suggests; acting on a suggestion takes a separate tool.

Sourcegithub.com · September 30, 2026 ↗

get_user_profile

Reads the profile Airmail has built from your habits: reply patterns, frequent contacts and saved templates.

When it helps
you want Claude to draft in your usual tone rather than a generic one.
Watch out
the profile only reflects what Airmail has learned so far.

Sourcegithub.com · September 30, 2026 ↗

suggest_folder

Suggests a folder for a message based on how you have filed similar mail before.

When it helps
a new vendor email arrives and you are unsure whether it belongs in Purchasing or Legal.
Watch out
it only suggests; filing the message takes another tool.

Sourcegithub.com · September 30, 2026 ↗

get_behavior_stats

Returns statistics from Airmail's behavior tracker: total actions, top sender-to-folder habits and domain patterns.

When it helps
you want to see which senders you always file by hand, before turning that into a rule.
Watch out
the statistics come from this Mac's history only.

Sourcegithub.com · September 30, 2026 ↗

list_accounts

Lists the email accounts configured in your Airmail, the starting point when you run a personal and a work address side by side.

When it helps
you want Claude to confirm which of your four addresses a search should cover.
Watch out
it shows what Airmail on this Mac knows, nothing from other computers.

Sourcegithub.com · September 30, 2026 ↗

list_folders

Returns the folders of one account, so Claude knows where your mail is filed before it looks inside.

When it helps
you file invoices in a folder whose exact name you no longer remember.
Watch out
it works account by account; name the address if you have several.

Sourcegithub.com · September 30, 2026 ↗

list_messages

Lists the messages of any folder, newest first, so Claude can scan a project folder or last year's records rather than just the inbox.

When it helps
you want the last exchanges filed under the client folder before a renewal call.
Watch out
it lists headers; the full body needs the message tool.

Sourcegithub.com · September 30, 2026 ↗

get_message

Opens one message in full: plain-text body, recipients, attachments list, subject, date and labels.

When it helps
a long supplier email needs a three-line summary before you decide who handles it.
Watch out
the body comes back as plain text, so formatting and images are not part of it.

Sourcegithub.com · September 30, 2026 ↗

list_inbox

Lists what sits in your inbox, most recent first, the view Claude uses to tell you what came in.

When it helps
you are back from two days off and want the arrivals grouped by topic.
Watch out
it covers the inbox only; other folders go through list_messages.

Sourcegithub.com · September 30, 2026 ↗

list_starred

Brings back your starred or flagged messages, newest first, the ones you marked as worth coming back to.

When it helps
Friday afternoon, you want to clear everything you flagged during the week.
Watch out
it only knows what you flagged; nothing is ranked by importance on its own.

Sourcegithub.com · September 30, 2026 ↗

list_sent

Shows what you sent, newest first, so Claude can check what you already told someone.

When it helps
you wonder whether you already sent the updated quote to the prospect last week.
Watch out
only mail sent from accounts Airmail manages shows up here.

Sourcegithub.com · September 30, 2026 ↗

list_trash

Shows what sits in the trash, newest first, which is handy to recover something thrown away too fast.

When it helps
a colleague swears she wrote yesterday and you suspect a rule binned her message.
Watch out
empty_folder can clear this folder for good, so look here before anyone runs it.

Sourcegithub.com · September 30, 2026 ↗

list_spam

Brings up the messages filed as spam or junk, newest first, so Claude can spot a real email caught by the filter.

When it helps
an invoice from a new supplier never arrived and you want to know if it landed in junk.
Watch out
reading a junk message can expose you to phishing links; let Claude summarize instead of clicking.

Sourcegithub.com · September 30, 2026 ↗

list_attachments

Lists the attachments of one message, with enough detail for Claude to pick the file you mean.

When it helps
a message carries six PDFs and you only need the signed contract among them.
Watch out
it lists files; opening one takes the attachment tool.

Sourcegithub.com · September 30, 2026 ↗

get_unread_counts

Gives the number of unread messages in each account's inbox, a quick pulse before diving in.

When it helps
you want to know which of your addresses needs attention first this morning.
Watch out
a count says nothing about urgency; ask for a triage if you need priorities.

Sourcegithub.com · September 30, 2026 ↗

search_contacts

Searches contacts and recent senders by name or email address, drawing on the people who actually email you.

When it helps
you remember a first name and a company, not the address of the person who wrote last month.
Watch out
it looks at correspondents; the address book has its own search tool.

Sourcegithub.com · September 30, 2026 ↗

get_draft

Opens a draft with its body, recipients and attachments, so Claude can pick up where you left off.

When it helps
you started an answer for a board member last night and want Claude to tighten it.
Watch out
reading a draft leaves it untouched; saving a new version is a separate tool.

Sourcegithub.com · September 30, 2026 ↗

get_message_thread

Pulls every message of a conversation thread in date order, oldest first, so Claude reads the exchange as it unfolded.

When it helps
a thread with twenty replies on a delayed shipment needs one paragraph on where things stand.
Watch out
long threads carry a lot of text; Claude may summarize parts rather than quote them.

Sourcegithub.com · September 30, 2026 ↗

get_attachment

Retrieves one specific attachment from a message so Claude can work with its content.

When it helps
you want the figures from a spreadsheet a client attached, without saving it yourself.
Watch out
an attachment from an unknown sender deserves the same caution in Claude as in your mail app.

Sourcegithub.com · September 30, 2026 ↗

list_windows

Lists the Airmail windows currently open on your Mac, composers and readers included.

When it helps
Claude opened a reply window earlier and you want to know if it is still waiting on screen.
Watch out
it describes windows, not their content; drafts are read with the draft tool.

Sourcegithub.com · September 30, 2026 ↗

list_operations

Reports the email operations in progress, each with its status: planned, executing, executed, failed, canceled or reverted.

When it helps
you asked for a large cleanup and want to confirm every step actually went through.
Watch out
a failed status means something did not happen; ask Claude which item and why.

Sourcegithub.com · September 30, 2026 ↗

list_activity

Reports the current email connections and synchronization activity, a view of what Airmail is doing with your servers right now.

When it helps
new mail seems stuck and you want to see whether an account is still syncing.
Watch out
it describes connections; it does not force a sync by itself.

Sourcegithub.com · September 30, 2026 ↗

list_rules

Lists every email rule with its name, whether it is enabled, a summary of its conditions and actions, and its direction.

When it helps
incoming invoices keep vanishing and you suspect an old rule is filing them away.
Watch out
listing rules leaves them untouched; create_rule, toggle_rule and delete_rule are the ones that act.

Sourcegithub.com · September 30, 2026 ↗

get_rule

Opens one rule in full: conditions, actions, keyboard shortcut and position in the order.

When it helps
you want to understand exactly what the rule named Newsletters does before touching it.
Watch out
reading a rule leaves it as it is; switching it off takes another tool.

Sourcegithub.com · September 30, 2026 ↗

list_signatures

Lists your email signatures, account by account, so Claude knows which one goes out where.

When it helps
a colleague says your signature still shows the old phone number and you want to check.
Watch out
signatures are set per account, so name the address you mean.

Sourcegithub.com · September 30, 2026 ↗

list_smart_folders

Lists your smart folders with their ID, name and saved search query.

When it helps
you built a folder for unpaid invoices months ago and want to see its query.
Watch out
a smart folder is a saved search; listing it leaves your mail where it is.

Sourcegithub.com · September 30, 2026 ↗

list_user_guides

Lists Airmail's built-in user guides, one per settings tab plus task and feature guides.

When it helps
you want to learn how Airmail handles something before asking Claude to set it up.
Watch out
these are Airmail's help pages, not your mail.

Sourcegithub.com · September 30, 2026 ↗

get_user_guide

Returns one Airmail user guide, picked from the guide list, as formatted text.

When it helps
Claude needs to explain the VIP settings tab and wants Airmail's own description.
Watch out
guides describe the app in general; they say nothing about your mailbox.

Sourcegithub.com · September 30, 2026 ↗

What Claude changes (50)

50 tools

Fifty tools that file, send, delete or edit. Two of them send immediately, without a window.

update_account_settings

Approval: see the rule

Changes the settings of one mail account in Airmail.

What Claude asks for
no source says whether Claude confirms before a change to account settings; the general approvals rule below covers it.
When it helps
an address should stop downloading remote images, and you would rather say it than dig through menus.
Watch out
a wrong value can disrupt that account until you set it back.

Sourcegithub.com · September 30, 2026 ↗

set_vacation_settings

Approval: see the rule

Sets the out-of-office auto-reply of an account, turning it on or off and defining its message.

What Claude asks for
Airmail documents no prompt of its own for switching an auto-reply on or off, so Claude's default approval rule is what applies.
When it helps
you leave tomorrow for two weeks and want the reply to name your backup colleague.
Watch out
an auto-reply answers everyone who writes, clients and newsletters alike.

Sourcegithub.com · September 30, 2026 ↗

mark_messages

Approval: see the rule

Applies flags to messages, such as read, unread or starred.

What Claude asks for
nothing specific is described for flagging a set of messages; see the general rule in the approvals section.
When it helps
Claude summarized a batch of newsletters and you want them all marked read.

Sourcegithub.com · September 30, 2026 ↗

archive_messages

Approval: see the rule

Moves messages to the archive, out of the inbox but still searchable.

What Claude asks for
no dedicated check is documented for archiving a set of messages; by default, Claude asks before acting on your account.
When it helps
the triage flagged twenty notifications as noise and you want the inbox clear.
Watch out
archived mail stays reachable; this is not deletion.

Sourcegithub.com · September 30, 2026 ↗

trash_messages

Approval: see the rule

Sends messages to the trash, where they wait until the trash is emptied.

What Claude asks for
no source says whether Claude confirms before sending messages to the trash; the general approvals rule below covers it.
When it helps
a mailing list you left keeps sending and you want this week's messages gone.
Watch out
from the trash, empty_folder can make them disappear for good.

Sourcegithub.com · September 30, 2026 ↗

move_messages

Approval: see the rule

Moves messages into a folder of your choice.

What Claude asks for
Airmail documents no prompt of its own for moving messages between folders, so Claude's default approval rule is what applies.
When it helps
Claude found every message about the office move and you want them in one project folder.

Sourcegithub.com · September 30, 2026 ↗

copy_messages

Approval: see the rule

Copies messages into a folder while the originals stay where they were.

What Claude asks for
nothing specific is described for copying messages into a folder; see the general rule in the approvals section.
When it helps
legal wants a copy of every exchange with a supplier in a dedicated folder, without touching your filing.

Sourcegithub.com · September 30, 2026 ↗

snooze_messages

Approval: see the rule

Snoozes messages so they leave your view and come back later.

What Claude asks for
no dedicated check is documented for snoozing messages; by default, Claude asks before acting on your account.
When it helps
a quote request cannot be answered before the pricing meeting on Thursday.

Sourcegithub.com · September 30, 2026 ↗

add_to_list

Approval: see the rule

Adds messages to Airmail's Todo, Memo or Done lists.

What Claude asks for
no source says whether Claude confirms before putting messages on a list; the general approvals rule below covers it.
When it helps
three client requests need action this week and you want them on your Todo list.

Sourcegithub.com · September 30, 2026 ↗

delete_messages

Approval: see the rule

Permanently deletes messages, skipping the trash.

What Claude asks for
Airmail documents no prompt of its own for a permanent deletion, so Claude's default approval rule is what applies.
When it helps
a message with sensitive data was sent to you by mistake and must not stay anywhere.
Watch out
there is no undo documented; check the selection twice.

Sourcegithub.com · September 30, 2026 ↗

empty_folder

Approval: see the rule

Empties the trash or the spam folder across all your accounts at once.

What Claude asks for
nothing specific is described for emptying trash or spam everywhere; see the general rule in the approvals section.
When it helps
the trash holds thousands of old messages and your disk is filling up.
Watch out
it hits every account in one go, not just the one you are looking at.

Sourcegithub.com · September 30, 2026 ↗

enable_disable_account

Approval: see the rule

Turns a mail account on or off in Airmail.

What Claude asks for
no dedicated check is documented for turning an account on or off; by default, Claude asks before acting on your account.
When it helps
you are on holiday and want the work address silent in Airmail until you return.
Watch out
a disabled account stops syncing, so its new mail waits on the server.

Sourcegithub.com · September 30, 2026 ↗

share_icloud

Approval: see the rule

Uploads a file to iCloud Drive and returns a public share link.

What Claude asks for
no source says whether Claude confirms before an upload to iCloud with a public link; the general approvals rule below covers it.
When it helps
an attachment is too heavy to forward and you would rather send a link.
Watch out
the link is public: anyone who gets it can open the file.

Sourcegithub.com · September 30, 2026 ↗

create_alias

Approval: see the rule

Creates a new email alias on one of your accounts.

What Claude asks for
Airmail documents no prompt of its own for creating an alias, so Claude's default approval rule is what applies.
When it helps
you want a dedicated address for a conference so its mail is easy to sort.

Sourcegithub.com · September 30, 2026 ↗

update_alias

Approval: see the rule

Updates an existing alias on one of your accounts.

What Claude asks for
nothing specific is described for editing an alias; see the general rule in the approvals section.
When it helps
the alias still shows last year's team name to recipients.

Sourcegithub.com · September 30, 2026 ↗

delete_alias

Approval: see the rule

Deletes an alias from an account.

What Claude asks for
no dedicated check is documented for removing an alias; by default, Claude asks before acting on your account.
When it helps
the event is over and the temporary address only attracts spam now.
Watch out
mail sent later to that address may no longer reach you.

Sourcegithub.com · September 30, 2026 ↗

create_event

Approval: see the rule

Creates a calendar event.

What Claude asks for
no source says whether Claude confirms before a new calendar event; the general approvals rule below covers it.
When it helps
a client agreed on a call next Tuesday at ten and you want it in the calendar before you forget.
Watch out
check which calendar receives it if you keep several.

Sourcegithub.com · September 30, 2026 ↗

update_event

Approval: see the rule

Edits an event already on your calendar.

What Claude asks for
Airmail documents no prompt of its own for editing an event, so Claude's default approval rule is what applies.
When it helps
the kickoff moved by an hour and the invite still shows the old time.

Sourcegithub.com · September 30, 2026 ↗

delete_event

Approval: see the rule

Deletes a calendar event.

What Claude asks for
nothing specific is described for deleting an event; see the general rule in the approvals section.
When it helps
a workshop was cancelled and the slot should free up for other meetings.
Watch out
on a recurring event, make sure which occurrence you mean.

Sourcegithub.com · September 30, 2026 ↗

create_reminder

Approval: see the rule

Creates a reminder.

What Claude asks for
no dedicated check is documented for a new reminder; by default, Claude asks before acting on your account.
When it helps
a partner asked you to call back after their board meeting on the fifteenth.

Sourcegithub.com · September 30, 2026 ↗

complete_reminder

Approval: see the rule

Marks a reminder as completed, or back to not completed.

What Claude asks for
no source says whether Claude confirms before ticking a reminder off; the general approvals rule below covers it.
When it helps
you just sent the promised document and want the reminder ticked off.

Sourcegithub.com · September 30, 2026 ↗

delete_reminder

Approval: see the rule

Deletes a reminder from your list for good.

What Claude asks for
Airmail documents no prompt of its own for deleting a reminder, so Claude's default approval rule is what applies.
When it helps
a follow-up became pointless after the prospect declined.

Sourcegithub.com · September 30, 2026 ↗

compose_email

Approval: see the rule

Opens a new compose window in Airmail, pre-filled with recipients, subject and text.

What Claude asks for
nothing specific is described for opening a pre-filled compose window; see the general rule in the approvals section.
When it helps
you want Claude to draft an intro between two contacts and leave the send button to you.
Watch out
the window waits on screen; nothing leaves until you click send yourself.

Sourcegithub.com · September 30, 2026 ↗

reply_to_message

Approval: see the rule

Opens a reply window for a message, ready for Claude's draft and your review.

What Claude asks for
no dedicated check is documented for opening a reply window; by default, Claude asks before acting on your account.
When it helps
Airmail's own example: open a reply thanking Sarah and proposing Tuesday at ten, without sending it.
Watch out
you still press send; the window is the checkpoint.

Sourcegithub.com · September 30, 2026 ↗

forward_message

Approval: see the rule

Opens a forward window for a message, so you can add a note and pick recipients before sending.

What Claude asks for
no source says whether Claude confirms before opening a forward window; the general approvals rule below covers it.
When it helps
a client complaint should reach your support lead with two lines of context from you.
Watch out
check attachments before sending; forwards carry them along.

Sourcegithub.com · September 30, 2026 ↗

quick_reply

Approval: see the rule

Replies to a message and sends it on the spot. Airmail's own description is blunt: it sends immediately.

What Claude asks for
Airmail documents no confirmation window here: the message leaves at once, so only Claude's default approval rule stands before the send.
When it helps
a colleague asks for a yes or no on the room booking and a two-word answer is enough.
Watch out
no compose window opens, so there is no screen to review before the message leaves.

Sourcegithub.com · September 30, 2026 ↗

send_email

Approval: see the rule

Sends a new email straight away, without opening a compose window.

What Claude asks for
no review window exists for this one; the only step before the send is Claude's default approval rule, described below.
When it helps
a routine confirmation to a supplier needs no rereading and you want it gone.
Watch out
Airmail flags it as sending immediately; once gone, it is gone.

Sourcegithub.com · September 30, 2026 ↗

save_as_draft

Approval: see the rule

Saves an email as a draft without opening a compose window.

What Claude asks for
no dedicated check is documented for saving a draft; by default, Claude asks before acting on your account.
When it helps
Claude drafted three follow-ups and you want them waiting in Drafts for tomorrow morning.

Sourcegithub.com · September 30, 2026 ↗

create_contact

Approval: see the rule

Creates a contact in your address book.

What Claude asks for
Airmail documents no prompt of its own for adding a contact, so Claude's default approval rule is what applies.
When it helps
you met a prospect at a trade show and want their card saved from the email signature.

Sourcegithub.com · September 30, 2026 ↗

update_contact

Approval: see the rule

Refreshes an existing contact with new details.

What Claude asks for
nothing specific is described for editing a contact; see the general rule in the approvals section.
When it helps
a client changed jobs and her new title and number arrived in her last email.

Sourcegithub.com · September 30, 2026 ↗

delete_contact

Approval: see the rule

Deletes a contact from the address book.

What Claude asks for
no dedicated check is documented for deleting a contact; by default, Claude asks before acting on your account.
When it helps
duplicate cards for the same person keep confusing autocomplete.
Watch out
remove the right duplicate; the card goes with all its details.

Sourcegithub.com · September 30, 2026 ↗

create_folder

Approval: see the rule

Adds a mail folder to one of your accounts.

What Claude asks for
no source says whether Claude confirms before creating a folder; the general approvals rule below covers it.
When it helps
a new client project starts and its mail deserves its own place from day one.

Sourcegithub.com · September 30, 2026 ↗

rename_folder

Approval: see the rule

Renames a mail folder.

What Claude asks for
Airmail documents no prompt of its own for renaming a folder, so Claude's default approval rule is what applies.
When it helps
the client changed its brand name and the folder should follow.
Watch out
rules or smart folders pointing at the old name may need a look.

Sourcegithub.com · September 30, 2026 ↗

delete_folder

Approval: see the rule

Deletes a custom folder.

What Claude asks for
nothing specific is described for deleting a custom folder; see the general rule in the approvals section.
When it helps
a project closed two years ago and its empty folder clutters the sidebar.
Watch out
check it is empty first; the description does not say what happens to mail inside.

Sourcegithub.com · September 30, 2026 ↗

add_vip

Approval: see the rule

Adds a sender to the VIP list.

What Claude asks for
no dedicated check is documented for adding a VIP sender; by default, Claude asks before acting on your account.
When it helps
a new investor starts writing and their mail must never get buried.

Sourcegithub.com · September 30, 2026 ↗

remove_vip

Approval: see the rule

Removes a sender from the VIP list.

What Claude asks for
no source says whether Claude confirms before removing a VIP sender; the general approvals rule below covers it.
When it helps
a former client still sits among your VIPs a year after the contract ended.

Sourcegithub.com · September 30, 2026 ↗

add_blocked

Approval: see the rule

Blocks a sender so their mail stops reaching you.

What Claude asks for
Airmail documents no prompt of its own for blocking a sender, so Claude's default approval rule is what applies.
When it helps
a cold-outreach tool keeps writing after three unsubscribe attempts.
Watch out
blocking a real contact by mistake silences them without warning.

Sourcegithub.com · September 30, 2026 ↗

remove_blocked

Approval: see the rule

Unblocks a sender so their mail can reach you again.

What Claude asks for
nothing specific is described for unblocking a sender; see the general rule in the approvals section.
When it helps
the partner who never got answers turns out to have been blocked years ago.

Sourcegithub.com · September 30, 2026 ↗

set_preferences

Approval: see the rule

Modifies Airmail's app preferences.

What Claude asks for
no dedicated check is documented for changing app preferences; by default, Claude asks before acting on your account.
When it helps
you want Airmail to stop showing previews in notifications on a shared screen.
Watch out
a preference change applies to the whole app, not one account.

Sourcegithub.com · September 30, 2026 ↗

update_user_profile

Approval: see the rule

Updates the behavior profile: custom instructions, reply tone and length, and templates to add or remove.

What Claude asks for
no source says whether Claude confirms before editing your profile; the general approvals rule below covers it.
When it helps
you want future drafts shorter and less formal than what Claude has been producing.

Sourcegithub.com · September 30, 2026 ↗

delete_draft

Approval: see the rule

Permanently deletes a draft.

What Claude asks for
no source says whether Claude confirms before deleting a draft for good; the general approvals rule below covers it.
When it helps
an old draft to a former client keeps resurfacing and you want it gone.
Watch out
the deletion is permanent, per Airmail's description.

Sourcegithub.com · September 30, 2026 ↗

create_rule

Approval: see the rule

Sets up an email rule with its conditions and actions.

What Claude asks for
Airmail documents no prompt of its own for creating a rule, so Claude's default approval rule is what applies.
When it helps
every shipping notification should skip the inbox and land in a Deliveries folder.
Watch out
a broad condition can catch more mail than you meant.

Sourcegithub.com · September 30, 2026 ↗

delete_rule

Approval: see the rule

Deletes a rule, identified by its ID.

What Claude asks for
nothing specific is described for deleting a rule; see the general rule in the approvals section.
When it helps
the old rule that filed invoices away is the culprit and should go.

Sourcegithub.com · September 30, 2026 ↗

toggle_rule

Approval: see the rule

Enables or disables a rule without deleting it.

What Claude asks for
no dedicated check is documented for switching a rule on or off; by default, Claude asks before acting on your account.
When it helps
you want to pause the newsletter rule during a campaign audit, then restore it.

Sourcegithub.com · September 30, 2026 ↗

create_signature

Approval: see the rule

Adds an email signature to one account, next to the existing ones.

What Claude asks for
no source says whether Claude confirms before creating a signature; the general approvals rule below covers it.
When it helps
you took a new role and want a signature with the new title on your work address.

Sourcegithub.com · September 30, 2026 ↗

update_signature

Approval: see the rule

Updates a signature's name, its HTML body or its default status.

What Claude asks for
Airmail documents no prompt of its own for editing a signature, so Claude's default approval rule is what applies.
When it helps
the phone number in your signature is wrong and every email repeats the mistake.

Sourcegithub.com · September 30, 2026 ↗

delete_signature

Approval: see the rule

Deletes a signature.

What Claude asks for
nothing specific is described for deleting a signature; see the general rule in the approvals section.
When it helps
a signature from a finished campaign keeps getting picked by mistake.
Watch out
make sure another signature stays the default for that account.

Sourcegithub.com · September 30, 2026 ↗

create_smart_folder

Approval: see the rule

Creates a smart folder from a search query, using the same syntax as Airmail's message search.

What Claude asks for
no dedicated check is documented for creating a smart folder; by default, Claude asks before acting on your account.
When it helps
you want a live view of every unanswered email from clients over the last month.

Sourcegithub.com · September 30, 2026 ↗

update_smart_folder

Approval: see the rule

Updates a smart folder's name, its search query, or both.

What Claude asks for
no source says whether Claude confirms before editing a smart folder; the general approvals rule below covers it.
When it helps
the unpaid invoices view should now also catch reminders from the new accounting tool.

Sourcegithub.com · September 30, 2026 ↗

delete_smart_folder

Approval: see the rule

Deletes a smart folder.

What Claude asks for
Airmail documents no prompt of its own for deleting a smart folder, so Claude's default approval rule is what applies.
When it helps
a view built for last year's audit has no use anymore.

Sourcegithub.com · September 30, 2026 ↗

Unclassified (7)

7 tools

Airmail gives these seven a one-line label, but no source says whether they read or change anything, so this page does not class them.

manage_capabilities

Airmail's manifest labels it as switching tool groups on or off to save context, but no source says whether that counts as reading or as changing anything, so this page leaves it unclassified.

Watch out
whatever it does, the general approvals rule below covers it.

start_convo

The publisher gives it a one-line label about opening a conversation session with an ID for request correlation; no source says whether it reads or alters your data, and this page goes no further.

Watch out
it falls under the same approval rule as the rest of the list.

refresh_inbox

Airmail describes it as fetching new emails from the server, yet no source says whether it only reads or also changes state in your mailbox, so it stays unclassified here.

Watch out
the default approvals rule applies to it like to any other tool.

analyze_email_history

According to its manifest line, it scans the sent folder to build a behavior profile of tone, contacts and topics; no source says whether that writes to the profile or only reads, so the page does not decide.

Watch out
whatever it produces, Claude's general rule on asking first covers it.

fetch_message_body

The publisher's label says it triggers a download of a message body from the server; no source states whether it reads or modifies anything, and this page stops at that.

Watch out
the general approvals rule covers it, as for every tool listed.

export_eml

Airmail's manifest says it exports a message as an .eml file saved to disk and returns its path; no source says how that should be classed, read or change, so the page leaves it open.

Watch out
a file lands on your Mac, and the default approvals rule covers the call.

semantic_index_status

Its one-line label reads check or trigger the semantic index; no source says whether a given call only reads the status or rebuilds something, so this page does not classify it.

Watch out
whatever it does, the approvals rule described below covers it.
Approvals

What Claude asks before acting

By default, Claude stops and asks for your go-ahead before any action it takes on an account for you. With Airmail, that default is the main safeguard: the publisher describes no confirmation of its own.

On a Team or Enterprise workspace, owners decide whether a member may let some actions through without being asked each time, and they can cap what a connector may do for the whole organization. That setting binds everyone. On the Airmail side, access starts with a pairing you approve in the app, and each paired client can be revoked in the MCP Permissions tab. Claude reaches only the accounts configured in Airmail on this Mac.

Plans

Which plans this is available on

None of the 819 sheets in the official directory shows availability per plan. Connector by connector, the answer is published nowhere: a real gap in the catalogue.

The general rule is published: desktop extensions install on Claude Desktop, while remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile. On Team and Enterprise, an Owner or Primary Owner enables a connector for the organization first. The directory sheet lists Claude Desktop as the only surface here, and it is the only place showing the current state.

Limits

Where this connector stops

A connector is not an automation. Claude calls these tools while it answers you: nothing starts when a new email lands, even if a rule of yours reacts to it inside Airmail.

Only the publisher documents this connector, through its GitHub README and extension manifest: no Claude help article covers it. The manifest gives one line per tool, enough to class most of them and not the last seven. The tool list is an observed floor, not a promise. The partner badge is not a security audit, and Anthropic says on every sheet that it does not choose the tools a publisher exposes nor guarantee their behavior. For other connectors, browse the Integrations hub.

Need help

Need help connecting Airmail to Claude?

A person reads every message.

FAQ

Claude Airmail connector: frequent questions

01What can Claude do with the Airmail connector?
Claude can work across Airmail on your Mac: read and search mail, including by meaning, triage the inbox with suggested actions, file, archive, snooze or delete messages, open pre-filled replies and forwards, send short answers, and manage drafts. It also reaches your calendar and reminders, your address book, VIP and blocked lists, rules, signatures, smart folders, aliases, out-of-office replies and app preferences. That adds up to 102 tools, 45 reading, 50 changing and 7 left unclassified.
02Can Claude send or delete email through Airmail?
Yes. Two tools send without any window: quick_reply answers a message on the spot and send_email sends a new email directly, both described by Airmail as sending immediately. Three others open a pre-filled compose, reply or forward window and leave the send button to you. On the deletion side, delete_messages and delete_draft are permanent, and empty_folder clears trash or spam across all accounts. Moving to the trash and archiving are not described as permanent.
03Does Claude ask before sending an email from Airmail?
By default, yes: Claude asks for confirmation before any action it takes on an account for you. Airmail itself describes no extra check, so for quick_reply and send_email that default is the only step before the message leaves. If you prefer to see the email first, ask Claude to use the reply or compose window instead. On a Team or Enterprise workspace, owners decide whether members may let some actions through without a prompt.
04Which Claude plans is the Airmail connector available on?
No official source publishes plan availability connector by connector, and no directory sheet displays it. The general rule says desktop extensions install on Claude Desktop, and this sheet lists Claude Desktop as the only surface. On Team and Enterprise, an Owner or Primary Owner enables a connector for the organization before members can use it. Airmail's README names no Claude plan. The directory sheet remains the place showing the current state for your account.
05Does Claude see every email account in Airmail?
Claude sees the accounts configured in Airmail on the Mac where the extension runs, and the tool groups currently enabled. It does not reach other computers or accounts Airmail does not manage. Access starts with a pairing you approve in Airmail and can be revoked per client in its MCP Permissions tab. On the Claude side, a Team or Enterprise owner can restrict what the connector may do for everyone, and a member cannot lift that from their own account.
06Why can't Claude reach Airmail?
Usually because Airmail is closed or its server is off. The bridge connects only to the Airmail app running on your Mac, and by default it exits with an error if the app is not reachable; an optional setting makes it launch Airmail instead. Check that the MCP server is enabled in Airmail's preferences. Airmail's README also lists macOS 13 or later and Node.js 18 or later on the Mac, and the pairing you approve on first use.
07Claude or an automation tool for Airmail?
They serve different needs, so it depends on the task. Claude works inside a conversation: you ask it to triage, file, draft or book, and nothing else happens once you stop typing. It never reacts on its own to incoming mail. For filing that must happen on every message without you, Airmail's own rules or an automation tool do that job. For a quick cleanup, a summary or a batch of replies on demand, the connector fits better.