# mgcrea/cupertino

Source: https://glimind.com/server/github%2Fmgcrea%2Fcupertino
Registry id: `github/mgcrea/cupertino`
Status: unknown

## Tools (80)

- `apple_calendar_create_event`: Create an event. THIS IS A REAL EVENT ON A REAL CALENDAR: on an iCloud, CalDAV or
- `apple_calendar_delete_events`: Delete whole events. Each result says whether the event ACTUALLY went — Calendar
- `apple_calendar_diagnostics`: Report which lanes are live, which macOS permissions are granted, and what each
- `apple_calendar_find_availability`: Find the times nothing is on the calendar, long enough to hold a meeting of a given
- `apple_calendar_get_event`: Full detail for one event: notes, location, URL, conference link, and whether it has
- `apple_calendar_list_accounts`: List the accounts Calendar syncs, with how many calendars each holds. Use this to scope
- `apple_calendar_list_calendars`: List every calendar with the account it belongs to, whether it is SHARED with other
- `apple_calendar_list_events`: List events in a date range, earliest first. Occurrences of repeating events are
- `apple_calendar_search_events`: Search events by text, most recent first. Unbounded in time unless you give `from` or
- `apple_calendar_update_event`: Change an existing event. On a shared calendar the change is visible to everyone else
- `apple_contacts_create_contact`: Create a new contact in the address book. This is a real card in the user's real
- `apple_contacts_diagnostics`: Report which Contacts stores were opened, how many contacts each holds, and what this
- `apple_contacts_get_contact`: One contact in full: name, organisation, job title, every phone number and every
- `apple_contacts_list_contacts`: List contacts across every account. This is the whole address book, so prefer
- `apple_contacts_resolve_handles`: Turn phone numbers or email addresses into contact names. Give it the raw identifiers
- `apple_contacts_search_contacts`: Search the address book by name, nickname or organisation. Returns a ref for each
- `apple_contacts_update_contact`: Change an existing contact, or add a phone number or email address to one. Omitting a
- `apple_mail_check_for_new_mail`: Ask Mail to sync now, for one account or all of them. Unlike the read tools this will
- `apple_mail_count_messages`: Count messages in a mailbox. Cheap in both lanes, so this works with no extra permissions.
- `apple_mail_create_mailbox`: Create a mailbox (a folder). Use this before apple_mail_move_messages when the
- `apple_mail_delete_messages`: Delete messages. This follows the account's own 'move deleted messages to Trash' setting,
- `apple_mail_diagnostics`: Report what this server can currently do and why. Shows whether Mail is running, whether
- `apple_mail_forward_message`: Forward a message to new recipients. By default it opens a draft in Mail for review.
- `apple_mail_get_message`: Read one message: decoded headers, the plain-text body, and a list of its attachments.
- `apple_mail_get_message_source`: Get the raw RFC 5322 source of a message — every header and the undecoded body. Use this
- `apple_mail_get_thread`: Get every message in the conversation containing a given message, oldest first, across
- `apple_mail_list_accounts`: List the mail accounts configured in Apple Mail: display name, UUID, type, addresses and
- `apple_mail_list_attachments`: List a message's attachments: filename, MIME type, size and whether the bytes are present
- `apple_mail_list_mailboxes`: List mailboxes, optionally with message counts. Counts cost one round-trip per mailbox
- `apple_mail_list_messages`: List the newest messages in one mailbox, most recent first. Returns a `ref` per message
- `apple_mail_list_open_drafts`: Read the drafts the user has open in Mail right now — every compose window, with its
- `apple_mail_move_messages`: Move messages to another mailbox, optionally in another account. The refs you passed in
- `apple_mail_query`: Answer a question ABOUT your mail without reading the mail. Takes the same index
- `apple_mail_reply_to_message`: Reply to a message. By default it opens a draft in Mail with the original quoted beneath
- `apple_mail_save_attachment`: Save one attachment to disk. It can only write into APPLE_MAIL_ATTACHMENT_DIR (default
- `apple_mail_search_messages`: Search mail by any combination of text, body text, sender, recipient, subject, mailbox,
- `apple_mail_send_message`: Compose a new message. By DEFAULT this does not send: it opens a draft in Mail for the
- `apple_mail_set_message_flags`: Set read / flagged / junk state on one or more messages. Pass only the fields you want to
- `apple_mail_update_draft`: Replace the body of an unsent draft — including a REPLY draft you have just written
- `apple_maps_add_favorite`: Save a place to Maps' favourites (the Pinned list). Give the place NAME as `query` — a
- `apple_maps_add_place_to_guide`: File a place into one of Maps' Guides, through the card's Add to Guides picker. This
- `apple_maps_diagnostics`: Report whether Maps' store can be read, which columns were resolved for each entity,
- `apple_maps_get_place`: Get one saved place by its ref, with coordinates, address and dates. Needs Full Disk
- `apple_maps_list_collection_places`: List the places filed in one collection, by its ref. Needs Full Disk Access. Returns
- `apple_maps_list_collections`: List the collections (Guides) in Maps. Each carries Maps' own count of the places in
- `apple_maps_list_favorites`: List the places saved as favourites in Maps, with coordinates, address and the label
- `apple_maps_list_recents`: List the places recently looked at in Maps, newest first. This is Maps' Recents list,
- `apple_maps_list_unfiled_places`: List saved places that are in no collection. Maps files a saved place into a Guide
- `apple_maps_remove_favorite`: Remove a place from Maps' favourites, by a ref from apple_maps_list_favorites. This
- `apple_maps_remove_saved_place`: Remove a place from Maps' Places library, through the card's overflow menu. This does
- `apple_maps_save_place`: Save a place into Maps' Places library, by pressing Add on its card. This is NOT a
- `apple_maps_search_places`: Search every saved place — favourites, collection entries and recents — by name, by
- `apple_messages_count_messages`: Count messages without reading them. Answers 'how many', 'how many did I send',
- `apple_messages_diagnostics`: Report whether the Messages store could be opened, how much is in it, whether names
- `apple_messages_find_codes`: Find one-time authentication codes (2FA/OTP) in recently received messages. Looks
- `apple_messages_get_message`: One message in full, with its tapbacks and attachments. Reactions are reported here
- `apple_messages_list_chats`: List conversations, most recently active first, with their participants and message
- `apple_messages_list_messages`: Read messages, newest first — the whole store, or one conversation, or a date window.
- `apple_messages_save_attachment`: Save one attachment from a conversation to disk — a photo, a video, a PDF, a voice
- `apple_messages_search_messages`: Search message text across every conversation. Matches are substring and
- `apple_messages_send_message`: Send a message to an existing conversation or to a phone number / email address.
- `apple_notes_add_attachment`: Attach a file to a note. This is the only way to put an image in a note — an <img> tag
- `apple_notes_create_note`: Create a note. Notes takes its title from the first line of the body, so `title` is
- `apple_notes_delete_notes`: Delete notes. They go to Recently Deleted rather than being destroyed, but this still
- `apple_notes_diagnostics`: Report which lanes are live, which macOS permissions are granted, and what each
- `apple_notes_get_note`: Read one note's full text by ref. Password-protected notes report as locked rather
- `apple_notes_list_accounts`: List the Notes accounts, with how many folders and notes each holds. Start here to
- `apple_notes_list_attachments`: List a note's attachments. Metadata only — retrieving the bytes needs Full Disk
- `apple_notes_list_folders`: List folders across every account. Folders nest, so each entry carries its depth and
- `apple_notes_list_notes`: List notes, newest first. Returns `notes` with a `ref` per note for the read and
- `apple_notes_move_note`: Move a note to another folder.
- `apple_notes_save_attachment`: Save one attachment to disk. Needs Full Disk Access. It can only write into
- `apple_notes_search_notes`: Search notes. `scope: "full"` (the default) matches the body text; `scope: "title"`
- `apple_notes_update_note`: Replace or append to a note's body. Editing the first line changes the title, because
- `apple_reminders_complete_reminders`: Tick reminders off, or un-tick them with `completed: false`. Separate from update
- `apple_reminders_create_reminder`: Create a reminder. With no list, it goes to the list Reminders itself treats as the
- `apple_reminders_list_accounts`: List the Reminders accounts, with how many lists and reminders each holds. Start here
- `apple_reminders_list_lists`: List every Reminders list, across accounts. Lists nest inside other lists (Reminders
- `apple_reminders_move_reminders`: Move reminders to another list. NOTE: Reminders' scripting interface makes a list
- `apple_reminders_update_reminder`: Change fields on one reminder. Anything you omit is left alone. Setting `due` to a

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
