icloud-mcp 1.0.2 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +29 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,9 +6,10 @@ A Model Context Protocol (MCP) server that connects Claude Desktop to your iClou
|
|
|
6
6
|
|
|
7
7
|
- 📬 Read and paginate through your inbox
|
|
8
8
|
- 🔍 Search emails by keyword, sender, or date range
|
|
9
|
-
- 🗑️ Bulk delete emails by
|
|
10
|
-
- 📁
|
|
9
|
+
- 🗑️ Bulk delete emails by any combination of filters
|
|
10
|
+
- 📁 Bulk move emails between folders with flexible filtering
|
|
11
11
|
- 📊 Analyze top senders to identify inbox clutter
|
|
12
|
+
- 🔢 Count emails matching any filter before taking action
|
|
12
13
|
- ✅ Mark emails as read/unread, flag/unflag
|
|
13
14
|
- 🗂️ List and create mailboxes
|
|
14
15
|
|
|
@@ -78,12 +79,15 @@ Fully quit Claude Desktop (Cmd+Q) and reopen it. You should now be able to manag
|
|
|
78
79
|
|------|-------------|
|
|
79
80
|
| `get_inbox_summary` | Total, unread, and recent email counts |
|
|
80
81
|
| `get_top_senders` | Top senders by volume from a sample of recent emails |
|
|
81
|
-
| `get_unread_senders` | Top senders of unread emails |
|
|
82
|
+
| `get_unread_senders` | Top senders of unread emails (supports `sampleSize` and `maxResults`) |
|
|
82
83
|
| `read_inbox` | Paginated inbox with sender, subject, date |
|
|
83
84
|
| `get_email` | Full content of a specific email by UID |
|
|
84
85
|
| `get_emails_by_sender` | All emails from a specific address |
|
|
85
86
|
| `get_emails_by_date_range` | Emails between two dates |
|
|
86
87
|
| `search_emails` | Search by keyword across subject, sender, and body |
|
|
88
|
+
| `count_emails` | Count emails matching any combination of filters without modifying them |
|
|
89
|
+
| `bulk_move` | Move emails matching any combination of filters between folders |
|
|
90
|
+
| `bulk_delete` | Delete emails matching any combination of filters |
|
|
87
91
|
| `flag_email` | Flag or unflag an email |
|
|
88
92
|
| `mark_as_read` | Mark an email as read or unread |
|
|
89
93
|
| `delete_email` | Move an email to Deleted Messages |
|
|
@@ -97,14 +101,34 @@ Fully quit Claude Desktop (Cmd+Q) and reopen it. You should now be able to manag
|
|
|
97
101
|
| `create_mailbox` | Create a new folder |
|
|
98
102
|
| `empty_trash` | Permanently delete all emails in Deleted Messages |
|
|
99
103
|
|
|
104
|
+
## Bulk Move & Delete Filters
|
|
105
|
+
|
|
106
|
+
`bulk_move` and `bulk_delete` accept any combination of these filters:
|
|
107
|
+
|
|
108
|
+
| Filter | Type | Description |
|
|
109
|
+
|--------|------|-------------|
|
|
110
|
+
| `sender` | string | Match exact sender email address |
|
|
111
|
+
| `domain` | string | Match any sender from this domain (e.g. `substack.com`) |
|
|
112
|
+
| `subject` | string | Keyword to match in subject |
|
|
113
|
+
| `before` | string | Only emails before this date (YYYY-MM-DD) |
|
|
114
|
+
| `since` | string | Only emails since this date (YYYY-MM-DD) |
|
|
115
|
+
| `unread` | boolean | `true` for unread only, `false` for read only |
|
|
116
|
+
| `flagged` | boolean | `true` for flagged only, `false` for unflagged only |
|
|
117
|
+
| `larger` | number | Only emails larger than this size in KB |
|
|
118
|
+
| `smaller` | number | Only emails smaller than this size in KB |
|
|
119
|
+
| `hasAttachment` | boolean | Only emails with attachments |
|
|
120
|
+
|
|
100
121
|
## Example Usage
|
|
101
122
|
|
|
102
123
|
Once configured, you can ask Claude things like:
|
|
103
124
|
|
|
104
125
|
- *"Show me the top senders in my iCloud inbox"*
|
|
126
|
+
- *"How many unread emails do I have from substack.com?"*
|
|
127
|
+
- *"Move all emails from substack.com older than 2023 to my Newsletters folder"*
|
|
128
|
+
- *"Delete all unread emails from linkedin.com before 2022"*
|
|
129
|
+
- *"Move everything in my old_folders/college folder to Archive"*
|
|
130
|
+
- *"How many emails do I have with attachments larger than 5MB?"*
|
|
105
131
|
- *"Delete all emails from no-reply@instagram.com"*
|
|
106
|
-
- *"How many unread emails do I have?"*
|
|
107
|
-
- *"Move all emails from newsletters@substack.com to my newsletters folder"*
|
|
108
132
|
- *"Show me emails from the last week"*
|
|
109
133
|
|
|
110
134
|
## Security
|