@assistantmail/assistantmail-mcp 1.2.1 → 1.3.0

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for [AssistantMail](https://assistant-mail.ai) — lets AI agents send and receive email through a managed mailbox.
 
-[Website](https://assistant-mail.ai) · [Privacy Policy](https://assistant-mail.ai/privacy.html) · [Terms of Use](https://assistant-mail.ai/terms.html)
+[Website](https://assistant-mail.ai) · [Privacy Policy](https://assistant-mail.ai/privacy.html) · [Terms of Use](https://assistant-mail.ai/terms.html) · [Contributing](./CONTRIBUTING.md)
 
 ## Installation
 
@@ -10,6 +10,21 @@ MCP server for [AssistantMail](https://assistant-mail.ai) — lets AI agents sen
 npx @assistantmail/assistantmail-mcp
 ```
 
+Requires Node.js 24 or newer.
+
+## For npm users
+
+If you are installing from npm and want the shortest setup path:
+
+1. Install/run with:
+
+  ```bash
+  npx -y @assistantmail/assistantmail-mcp
+  ```
+
+2. Set `ASSISTANT_MAIL_API_KEY` in your MCP client environment.
+3. Call `assistantmail_list_mailboxes` first to get your `mailboxId`.
+
 ### Claude Desktop
 
 ```json
@@ -88,6 +103,7 @@ Mail API routes use a `mailboxId` (UUID), not an email address. Use `assistantma
 | `assistantmail_list_messages` | List inbound and outbound messages for a mailbox. Supports `since` (ISO timestamp) and `limit` (max 100). |
 | `assistantmail_get_message` | Fetch a single message including `textBody` and `htmlBody`. Bodies are only returned within the plan's retention window; `bodyExpired: true` is set if the window has elapsed. |
 | `assistantmail_send_email` | Queue an outbound email. Requires `to`, `subject`, and at least one of `text` or `html`. |
+| `assistantmail_reply_message` | Reply to an existing message. Requires `messageId` and at least one of `text` or `html`; recipients and subject are derived automatically. |
 | `assistantmail_delete_messages` | Delete messages by `messageIds` array, or pass `deleteAll: true` to clear the mailbox. |
 | `assistantmail_get_usage` | Get daily and monthly send quota usage for a mailbox. A `null` limit means unlimited. |
 
@@ -159,6 +175,17 @@ curl "$BASE/v1/mailboxes/<mailboxId>/messages" -H "x-api-key: $API_KEY"
 }
 ```
 
+```json
+{
+  "tool": "assistantmail_reply_message",
+  "input": {
+    "mailboxId": "<uuid>",
+    "messageId": "<uuid>",
+    "text": "Thanks for the update."
+  }
+}
+```
+
 If `ASSISTANT_MAIL_API_KEY` is set in the server environment, `apiKey` can be omitted from all tool inputs.
 
 ---

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@assistantmail/assistantmail-mcp",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "AssistantMail MCP server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AssistantMail/assistantmail-mcp.git"
+  },
+  "homepage": "https://assistant-mail.ai",
+  "bug": {
+    "url": "https://github.com/AssistantMail/assistantmail-mcp/issues"
+  },
   "type": "module",
   "bin": {
     "assistantmail-mcp": "src/index.js"
@@ -13,6 +21,7 @@
   ],
   "scripts": {
     "build": "node --check src/index.js",
+    "lint": "node --check src/index.js",
     "start": "node src/index.js"
   },
   "keywords": [
@@ -22,13 +31,13 @@
     "openai",
     "OpenClaw"
   ],
-  "author": "Crider Technologies",
+  "author": "AssistantMail",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=24"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",

package/src/index.js

@@ -504,6 +504,74 @@ server.tool(
   },
 );
 
+server.tool(
+  'assistantmail_reply_message',
+  'Replies to an existing message in a mailbox thread.',
+  {
+    mailboxId: z.string().min(1),
+    messageId: z.string().min(1),
+    text: z.string().optional(),
+    html: z.string().optional(),
+    apiKey: z.string().startsWith('amk_').optional(),
+  },
+  async ({ mailboxId, messageId, text, html, apiKey }) => {
+    if (!text && !html) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'assistantmail_reply_message failed: Provide at least one of text or html.',
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    try {
+      const result = await assistantMailPost(
+        `/v1/mailboxes/${mailboxId}/messages/${messageId}/reply`,
+        apiKey,
+        { text, html },
+      );
+      const reply = result.data;
+      if (
+        !reply
+        || typeof reply !== 'object'
+        || typeof reply.messageId !== 'string'
+        || typeof reply.status !== 'string'
+        || typeof reply.inReplyTo !== 'string'
+        || typeof reply.subject !== 'string'
+      ) {
+        throw new Error('AssistantMail API returned an unexpected reply payload.');
+      }
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `Queued reply for message ${messageId} in mailbox ${mailboxId}.`,
+          },
+        ],
+        structuredContent: {
+          messageId: reply.messageId,
+          status: reply.status,
+          inReplyTo: reply.inReplyTo,
+          subject: reply.subject,
+        },
+      };
+    } catch (error) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `assistantmail_reply_message failed: ${error instanceof Error ? error.message : String(error)}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+  },
+);
+
 server.tool(
   'assistantmail_delete_messages',
   'Deletes messages from a mailbox by IDs or deletes all messages.',