airmail-mcp 1.0.12 → 1.0.13

package/README.md

@@ -172,6 +172,45 @@ 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 | Email read, actions, compose | Always on |
+| profile | User profile, triage, behavior stats | On |
+| folders | Folder CRUD | On |
+| semantic | Semantic search, index status | On |
+| calendar | Calendar events, reminders | On |
+| contacts | Address book | On |
+| preferences | App preferences | On |
+| rules | Email rules | On |
+| lists | VIP & blocked senders | On |
+| smartfolders | Smart folder CRUD | On |
+| signatures | Email signatures | On |
+| aliases | Email aliases | 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/package.json

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