airmail-mcp 1.0.12 → 1.0.14

package/README.md

@@ -122,7 +122,7 @@ export AIRMAIL_MCP_TOKEN="your-token-here"
 
 To find your token: open Airmail → **Preferences → MCP** → copy the **Auth Token**.
 
-## Tools (97)
+## Tools (98)
 
 ### 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`
@@ -172,6 +172,44 @@ To find your token: open Airmail → **Preferences → MCP** → copy the **Auth
 ### Meta
 `manage_capabilities` — enable/disable tool groups to reduce context usage
 
+## Tool groups
+
+Tools are organized into capability groups that can be enabled or disabled at runtime via `manage_capabilities`. This reduces context usage by hiding tools you don't need.
+
+| Group | Tools | Default |
+|-------|-------|---------|
+| mail | read, action, compose | Always on |
+| profile | user profile & behavior | On |
+| folders | folder create/rename/delete | On |
+| semantic | semantic search & index | On |
+| calendar | calendar & reminder | On |
+| contacts | address book | On |
+| preferences | app preferences read/write | On |
+| rules | email rules CRUD | On |
+| lists | VIP & blocked sender lists | On |
+| smartfolders | smart folder CRUD | On |
+| signatures | email signature CRUD | On |
+| aliases | email alias CRUD | On |
+| accountsettings | per-account settings & vacation | On |
+To enable all groups, ask the AI to call `manage_capabilities` with `enable: ["preferences", "rules", "lists", "smartfolders", "signatures", "aliases", "accountsettings"]`.
+
+## Deep links
+
+MCP tool responses include `airmail://` deep links that open Airmail directly to the relevant content.
+
+| Command | URL | Description |
+|---------|-----|-------------|
+| `message` | `airmail://message?mail=...&messageid=...` | Select message in main window |
+| `open` | `airmail://open?mail=...&messageid=...` | Open message in reader window |
+| `compose` | `airmail://compose?to=...&subject=...` | Open composer with pre-filled content |
+| `reply` | `airmail://reply?mail=...&messageid=...` | Reply to a message |
+| `draft` | `airmail://draft?mail=...&messageid=...` | Open draft in composer |
+| `archive` | `airmail://archive?mail=...&messageid=...` | Archive a message |
+| `delete` | `airmail://delete?mail=...&messageid=...` | Move message to trash |
+| `view` | `airmail://view?mail=...&folder=...` | Navigate to account/folder |
+| `attachment` | `airmail://attachment?mail=...&messageid=...&index=0` | Open an attachment |
+| `settings` | `airmail://settings?pref=mcp_server` | Open Preferences pane |
+
 ## How it works
 
 ```

package/manifest.json

@@ -370,6 +370,10 @@
       "name": "semantic_index_status",
       "description": "Check/trigger semantic index."
     },
+    {
+      "name": "get_navigation_link",
+      "description": "Get an airmail:// deep link to navigate the user to a specific part of Airmail."
+    },
     {
       "name": "list_rules",
       "description": "List all email rules with name, guid, enabled, conditions/actions summary, direction."

package/package.json

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