airmail-mcp 1.0.21 → 1.0.23

package/README.md

@@ -175,7 +175,7 @@ On first use, the bridge asks Airmail to pair this MCP client. Airmail shows an
 
 Airmail MCP does not use a global auth token. Access is pairing-only and can be revoked per client in Airmail's MCP Permissions tab.
 
-## Tools (101)
+## Tools (102)
 
 ### Email (core)
 `list_accounts` · `list_folders` · `list_messages` · `get_message` · `list_inbox` · `list_starred` · `list_sent` · `list_trash` · `list_spam` · `search_messages` · `fetch_message_body` · `list_attachments` · `get_attachment` · `get_unread_counts` · `search_contacts` · `get_draft` · `delete_draft` · `get_message_thread` · `list_windows` · `export_eml`
@@ -222,6 +222,9 @@ Airmail MCP does not use a global auth token. Access is pairing-only and can be
 ### Preferences
 `get_preferences` · `set_preferences`
 
+### Documentation
+`list_user_guides` · `get_user_guide`
+
 ### Meta
 `manage_capabilities` — enable/disable tool groups to reduce context usage
 
@@ -244,6 +247,7 @@ Tools are organized into capability groups that can be enabled or disabled at ru
 | signatures | email signature CRUD | On |
 | aliases | email alias CRUD | On |
 | accountsettings | per-account settings & vacation | On |
+| documentation | built-in user guides (read-only) | On |
 To enable all groups, ask the AI to call `manage_capabilities` with `enable: ["preferences", "rules", "lists", "smartfolders", "signatures", "aliases", "accountsettings"]`.
 
 ## Deep links

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "airmail-mcp",
   "display_name": "Airmail",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Manage emails, calendars, contacts, and more from Claude using Airmail's MCP server.",
   "long_description": "Airmail MCP connects Claude to the Airmail email client for macOS. Read, search, compose, and organize emails. Manage calendars and reminders. Search contacts. The bridge connects locally to Airmail on your Mac. Data retrieved by AI tools is processed by your chosen AI provider.",
   "author": {
@@ -309,23 +309,19 @@
     },
     {
       "name": "list_starred",
-      "description": "List starred/flagged messages."
+      "description": "List starred/flagged messages (date desc)."
     },
     {
       "name": "list_sent",
-      "description": "List sent messages."
+      "description": "List sent messages (date desc)."
     },
     {
       "name": "list_trash",
-      "description": "List trash messages."
+      "description": "List trash messages (date desc)."
     },
     {
       "name": "list_spam",
-      "description": "List spam/junk messages."
-    },
-    {
-      "name": "search_messages",
-      "description": "Search emails with hybrid FTS + semantic engine."
+      "description": "List spam/junk messages (date desc)."
     },
     {
       "name": "fetch_message_body",
@@ -357,7 +353,7 @@
     },
     {
       "name": "get_attachment",
-      "description": "Get the content of a specific attachment."
+      "description": "Get a specific attachment."
     },
     {
       "name": "list_windows",
@@ -438,6 +434,14 @@
     {
       "name": "delete_smart_folder",
       "description": "Delete a smart folder."
+    },
+    {
+      "name": "list_user_guides",
+      "description": "List Airmail's built-in user guides (every Settings tab plus task/feature guides)."
+    },
+    {
+      "name": "get_user_guide",
+      "description": "Read one Airmail user guide by slug (from list_user_guides), returned as Markdown."
     }
   ],
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airmail-mcp",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "mcpName": "io.github.airmail/airmail-mcp",
   "description": "Manage emails, calendars, contacts, and more from Claude using Airmail's MCP server.",
   "main": "dist/index.js",