airmail-mcp 1.0.7 → 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/dist/index.js

@@ -11,8 +11,10 @@
  * collect all data before the FIN arrives.
  */
 import { execFileSync, spawnSync } from "child_process";
-import { writeSync } from "fs";
+import { readFileSync, writeSync } from "fs";
 import * as net from "net";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
 // ---------------------------------------------------------------------------
 // Configuration
 // ---------------------------------------------------------------------------
@@ -29,7 +31,15 @@ const AIRMAIL_PORT = (() => {
     return p;
 })();
 const AIRMAIL_PATH = "/mcp";
-const VERSION = "1.0.0";
+const VERSION = (() => {
+    try {
+        const pkg = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+})();
 let currentToken = "";
 const RETRY_DELAY_MS = 2000;
 const MAX_LAUNCH_RETRIES = 5;
@@ -286,7 +296,7 @@ function forward(body, clientName, token, hasId) {
             reqHeaders += `Connection: close\r\n`;
             reqHeaders += `User-Agent: airmail-mcp/1.0\r\n`;
             if (token) {
-                reqHeaders += `Authorization: Bearer ${token}\r\n`;
+                reqHeaders += `Authorization: Bearer ${sanitizeHeaderValue(token)}\r\n`;
             }
             reqHeaders += `X-MCP-Client: ${safeClient}\r\n`;
             if (parentCodeSignTeamID) {
@@ -485,7 +495,23 @@ async function main() {
                         }
                         pendingAfterInit = [];
                     })
-                        .catch((err) => log(`Initialize error: ${err}`));
+                        .catch((err) => {
+                        log(`Initialize error: ${err}`);
+                        // Send error responses for queued requests so clients don't hang
+                        for (const queued of pendingAfterInit) {
+                            try {
+                                const q = JSON.parse(queued);
+                                if (q.id !== undefined) {
+                                    process.stdout.write(JSON.stringify({
+                                        jsonrpc: "2.0", id: q.id,
+                                        error: { code: -32002, message: "Server failed to initialize" },
+                                    }) + "\n");
+                                }
+                            }
+                            catch { /* not valid JSON, skip */ }
+                        }
+                        pendingAfterInit = [];
+                    });
                     inflight.add(p);
                     p.finally(() => {
                         inflight.delete(p);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airmail-mcp",
-  "version": "1.0.7",
+  "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",