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.

Tool	Description
list-mailboxes	List all mailboxes across all accounts with unread counts
list-accounts	List configured mail accounts with email addresses and type
list-signatures	List available email signatures
search-messages	Search messages by subject or sender (empty query lists all)
read-message	Read the full content of a specific email
get-message-source	Get raw RFC822 source of a message
list-attachments	List attachments on a message with name, MIME type, size
save-attachment	Save email attachments to disk
compose-message	Create a draft in Mail.app (does not send) — supports plain or HTML body via htmlBody, plus attachments
send-message	Send an email immediately (supports from, attachments, plain or HTML body via htmlBody)
reply-to-message	Reply or reply-all to a message — threads correctly and supports a branded htmlBody or attachments
forward-message	Forward a message to new recipients
redirect-message	Redirect a message (preserves original sender)
move-messages	Move messages between mailboxes
delete-messages	Delete messages by Message-ID
mark-as-read	Mark messages as read
mark-as-junk	Mark/unmark messages as junk
flag-message	Flag/unflag messages with color support
set-message-color	Set background color of messages in the message list
check-for-new-mail	Trigger a mail fetch for one or all accounts
extract-email-address	Parse "John Doe <jdoe@example.com>" into name and address

Numbers (numbersmcp) — 29 tools

Works with any open Numbers spreadsheet.

Tool	Description
list-spreadsheets	List all open Numbers documents
create-document	Create a new Numbers document
list-sheets	List sheets and tables in a document
get-active-sheet	Get the currently active sheet
read-range	Read cell values from a range (e.g. "A1:C10")
read-table	Read an entire table as structured data
write-cell	Write a value to a specific cell
write-range	Write multiple values to a range
clear-range	Clear contents and formatting of a cell range
get-formula	Get the formula from a cell
set-formula	Set a formula on a cell
add-row	Append a row to a table
delete-row	Delete a row from a table
add-column	Add a column to a table
delete-column	Delete a column from a table
resize-row-column	Set row height or column width
add-sheet	Add a new sheet to a document
delete-sheet	Delete a sheet from a document
rename-sheet	Rename a sheet
add-table	Add a new table to a sheet
delete-table	Delete a table from a sheet
rename-table	Rename a table
sort-table	Sort a table by a column
transpose-table	Swap rows and columns of a table
merge-cells	Merge a range of cells
unmerge-cells	Unmerge previously merged cells
set-cell-format	Set cell format (number, currency, date, percentage, etc.)
set-cell-style	Set font, color, background, bold, italic, alignment
export-document	Export to PDF, Excel, or CSV

Contacts (@aernoud/contactsmcp) — 15 tools

Works with the system address book — all accounts synced to Contacts.app.

Tool	Description
search-contacts	Search contacts by name, email, or phone
search-by-modification-date	Find contacts modified after a given date
read-contact	Get full contact details
get-my-card	Get the user's own contact card
get-vcard	Export a contact as vCard 3.0 text
create-contact	Create a new contact
update-contact	Update contact fields
delete-contact	Delete a contact
list-groups	List all contact groups
create-group	Create a new contact group
rename-group	Rename a contact group
delete-group	Delete a contact group
add-to-group	Add a contact to a group
remove-from-group	Remove a contact from a group
list-group-members	List all contacts in a group

Calendar (calendarmcp) — 25 tools

Works with every calendar configured in Calendar.app — iCloud, Google, Exchange, local, you name it.

Tool	Description
list-calendars	List all calendars with name, writable flag, description
get-calendar	Get properties of a single calendar by name (incl. event count)
create-calendar	Create a new calendar
update-calendar	Rename a calendar or set its description
delete-calendar	Not supported by Calendar.app — returns a descriptive error; calendars must be removed from the Calendar.app UI
switch-view	Switch Calendar.app to day/week/month view, optionally jumping to a date
reload-calendars	Force Calendar.app to refresh from accounts
list-events	List events in a calendar between two ISO dates
search-events	Search events by summary substring within a date window (defaults: −30d to +365d). Scope to a single calendar for speed
get-event	Get full event details by uid
create-event	Create an event with summary, start, end, optional location/description/url
update-event	Patch any event field by uid
delete-event	Delete an event by uid
move-event	Move an event to another calendar (delete + recreate; new uid)
duplicate-event	Duplicate an event into the same or another calendar
today-events	List today's events in one calendar or across all
upcoming-events	List events in the next N days
list-attendees	List attendees on an event
add-attendee	Add an attendee with email and optional display name
remove-attendee	Remove an attendee by email
list-alarms	List display, mail, and sound alarms on an event
add-display-alarm	Add a display alarm N minutes before event start
add-sound-alarm	Add a sound alarm N minutes before event start
add-mail-alarm	Add a mail alarm N minutes before event start
remove-alarm	Remove an alarm by 1-based index from list-alarms output

Reminders (@aernoud/remindersmcp) — 22 tools

Works with every reminder list configured in Reminders.app — iCloud, Exchange, local, you name it.

Tool	Description
list-accounts	List all accounts in Reminders.app with name and id
list-lists	List every reminder list, optionally scoped to one account
get-list	Get properties of a single list (id, account, color, emblem, open + completed counts)
create-list	Create a new list, optionally in a specific account
update-list	Rename a list
delete-list	Delete a list (Reminders.app supports this directly via AppleScript, unlike Calendar.app)
show-list	Bring a list to the front in Reminders.app
list-reminders	List reminders in a named list (excludes completed by default)
search-reminders	Search reminders by name substring; scope to one list for speed
get-reminder	Get full reminder details by id
today-reminders	List reminders due today, scoped to one list or all
upcoming-reminders	List reminders due in the next N days
overdue-reminders	List reminders past their due date and not yet completed
create-reminder	Create a reminder with body, due date or all-day due date, remind-me date, priority, flagged
update-reminder	Patch any reminder field by id
delete-reminder	Delete a reminder by id
complete-reminder	Mark a reminder as completed (Reminders auto-stamps completion date)
uncomplete-reminder	Mark a previously completed reminder as not completed
move-reminder	Move a reminder to a different list (uses the native move verb — id is preserved)
flag-reminder	Set or clear the flagged state
set-priority	Set priority to none / high / medium / low (mapped to Reminders' 0/1/5/9 enum)
show-reminder	Bring Reminders.app to the front and focus a specific reminder

FaceTime (facetimemcp) — 3 tools

Initiates calls by handing URL schemes to open. Phone calls require an iPhone paired via Continuity (so macOS can route them through your phone).

Tool	Description
call-phone	Place a cellular call via paired iPhone (tel://)
call-facetime-audio	Start a FaceTime audio call to a phone number or Apple ID email
call-facetime-video	Start a FaceTime video call to a phone number or Apple ID email

Phone numbers are normalized + validated as E.164 (+15551234567); spaces, dashes, and parens are tolerated. macOS may show a confirmation prompt before dialing — there is no fully silent dial path, by design.

Requirements

• macOS (uses AppleScript — won't work on Linux/Windows)
• Node.js 18+

Install

From npm