Numbersmcp

Create a new email draft in Mail.app (opens compose window, does NOT send). Pass from to pre-select a specific sender account (must be configured in Mail.app). Pass htmlBody for a rich-text/HTML draft; the recipient will see rendered formatting (headings, bold, links) instead of raw tags. When htmlBody is supplied, body is still used as a plain-text fallback for clients that read plain content.

Create a new calendar in macOS Calendar.app

Create a new contact in macOS Contacts.app

Create a new Numbers document, optionally saving it with a given name

Create a new event in a named calendar

Create a new contact group in macOS Contacts.app

Create a new reminder list. If accountName is omitted, the list is created in the default account.

Create a new reminder in a named list. Pass `dueDate` for a timed due date, OR `allDayDueDate` for a date-only due date — never both.

Check whether a calendar exists, then return an error explaining that Calendar.app does NOT support deleting calendars via AppleScript (returns -10000). Calendars must be removed from the Calendar.app UI manually.

Delete a column from a Numbers table

Delete a contact from macOS Contacts.app

Delete an event by uid

Delete a contact group from macOS Contacts.app

Delete a reminder list by name. Reminders.app supports this directly via AppleScript (unlike Calendar.app).

Delete one or more email messages by their Mail local IDs or RFC Message-IDs

Delete a reminder by id

Delete a row from a Numbers table

Delete a sheet from a Numbers document

Delete a table from a sheet in a Numbers document

Duplicate an event into the same calendar or a different one

Export a Numbers document to PDF, Excel, or CSV format

Parse a formatted email string (e.g. 'John Doe <jdoe@example.com>') into name and address

Flag or unflag one or more email messages with a color flag

Set or clear the flagged state on a reminder

Forward an existing email message to one or more recipients

Get the name of the currently active sheet in a Numbers document

Get properties of a single calendar by name

Get full details of an event by its uid (searches all calendars)

Get the formula from a specific cell in a Numbers table

Get properties of a single list by name (id, account, color, emblem, open + completed reminder counts)

Get the raw RFC822 source of an email message

Get the user's own contact card from macOS Contacts.app

Get full details of a reminder by id (searches all lists). Returns name, body, completed, completion/creation/modification dates, due date, allday due date, remind me date, priority, flagged.

Get the vCard 3.0 text for a contact by their Contacts.app ID

List all Mail.app accounts with their email addresses, type, and enabled status

List display, mail, and sound alarms on an event with their trigger interval (minutes relative to start)

List all attachments of an email message with metadata

List attendees on an event by uid

List all calendars in macOS Calendar.app with name, writable flag, and description (calendars are identified by name; Calendar.app exposes no usable id)

List events in a calendar between two ISO dates

List all contacts in a group in macOS Contacts.app

List all contact groups in macOS Contacts.app with member counts

List every reminder list, optionally scoped to a single account by name. Returns id, name, container account, color, and emblem for each list.

List all mailboxes across all Mail.app accounts with unread counts

List reminders in a named list. Excludes completed by default.

List all sheets and tables in an open Numbers document

List all email signatures configured in Mail.app

List all open Numbers documents

Mark or unmark one or more email messages as junk/spam

Mark one or more email messages as read

Merge a range of cells in a Numbers table

Move an event to a different calendar. AppleScript cannot reparent directly, so this deletes the original and recreates it in the target calendar (the new event has a fresh uid).

Move one or more email messages to a different mailbox

Move a reminder to a different list (uses Reminders.app's native `move` verb — id is preserved)

List reminders whose due date is in the past and that are not yet completed.

Get full details of a contact by their Contacts.app ID

Read the full content of a specific email message

Read cell values from a range in a Numbers table (e.g. 'A1:C10')

Read an entire Numbers table as structured data

Redirect an email message to new recipients (preserves original sender, unlike forward)

Force Calendar.app to refresh / reload all calendars from their accounts

Remove an alarm from an event by 1-based index within its combined display+mail+sound alarm list (matching list-alarms output)

Remove an attendee from an event by email

Remove a contact from a group in macOS Contacts.app

Rename a contact group in macOS Contacts.app

Rename a sheet in a Numbers document

Rename a table in a Numbers document

Reply to an existing email message. The reply inherits correct threading headers (In-Reply-To / References) from Mail's native reply, so it nests in the thread even in strict clients (Outlook, Gmail web). Pass htmlBody for a branded rich-text/HTML reply; the HTML is rendered above the quoted thread and Mail derives the plain-text fallback. htmlBody cannot be combined with attachments (Mail corrupts the HTML during MIME composition). When htmlBody is supplied, the plain-text body is ignored.

Resize the height of a row or the width of a column in a Numbers table. At least one of row (with height) or column (with width) must be provided.

Save email attachments to disk

Find contacts modified after a given date in macOS Contacts.app

Search contacts in macOS Contacts.app by name, email, or phone number

Search events by summary substring across one calendar or all calendars. Bounded by a date window (defaults: −30d to +365d) to stay under the osascript timeout.

Search messages in a mailbox by subject or sender

Search reminders by name substring. Optionally scope to one list (recommended — `whose` filters scan every reminder).

Create and immediately send an email via Mail.app. Pass htmlBody to send a rich-text/HTML message; the recipient will see rendered formatting (headings, bold, links) instead of raw tags. When htmlBody is supplied, body is still used as a plain-text fallback for clients that read plain content.

Set the format of a cell (number, currency, percentage, date, text, etc.)

Set visual styling properties on a cell (font, color, bold, italic, alignment, background)

Set a formula on a specific cell in a Numbers table (prefix with '=' e.g. '=SUM(B1:B10)')

Set the background color highlight of one or more email messages in Mail.app

Set the priority of a reminder. Maps to Reminders.app's integer enum: none=0, high=1, medium=5, low=9.

Bring a list to the front in Reminders.app

Bring Reminders.app to the front and focus a specific reminder

Sort a Numbers table by a column

Switch Calendar.app to day, week, or month view, optionally jumping to a specific date

List today's events in one calendar or across all calendars

List reminders due today, scoped to one list or all lists.

Transpose rows and columns of a Numbers table

Mark a previously completed reminder as not completed

Unmerge a range of cells in a Numbers table

List events in the next N days in one calendar or across all calendars

List reminders due in the next N days, scoped to one list or all lists.

Rename a calendar or set its description

Update fields on an existing contact in macOS Contacts.app

Patch fields on an existing event by uid

Rename a reminder list

Patch fields on an existing reminder by id

Write a value to a specific cell in a Numbers table

Write multiple values to a range starting at a cell in a Numbers table