list-reminders
listName (string, optional), includeCompleted (boolean, optional), count (number, optional)
How to use it
list-reminders is exposed by the Icloud MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the list-reminders tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Icloud MCP
claude mcp add --transport stdio icloud -- npx -y mcp-icloudOther tools in Icloud MCP (39)
reminderId (string), completed (boolean, optional)
displayName, firstName, lastName, email, phone, organization, title, notes (all optional)
summary, start, end (strings, ISO 8601); description, location (optional); calendarUrl (cloud) or calendarName (local)
title (string), body (string, optional), folderName (string, optional)
name (string); body, dueDate, listName (optional); priority (number 0-9, optional)
contactUrl (string)
eventUrl (string)
reminderId (string)
no input
no input
limit (number, optional)
no input (local only)
accountId (string, optional) (local only)
count (number, optional, max 50)
folder (string, optional), count (number, optional, max 50)
count (number, optional, max 50), daysAhead (number, optional)
no input
no input
folderName (string, optional), count (number, optional)
no input
no input
uid (string), folder (string, optional), isRead (boolean, optional)
url (string), inNewWindow (boolean, optional)
chatId (number), type (love, like, dislike, laugh, emphasis, question)
contactUrl (string)
uid (string), folder (string, optional)
chatId (number); limit (number, optional); start, end (ISO 8601, optional); attachments (boolean, optional)
noteId (string)
query (string), count (number, optional). Matches name, organisation, email and phone; phone matching ignores formatting
query, from, subject, folder (strings, optional), unreadOnly (boolean, optional), count (number, optional)
query (string), count (number, optional)
query (string), count (number, optional)
to, subject, body (strings); cc, bcc (strings, optional); isHtml (boolean, optional, cloud mode only)
to (string), body (string), file (string, optional)
eventUrl (string); any of summary, start, end, description, location. Only the fields you pass change
reminderId (string); any of name, body, dueDate, priority