@assistantmail/assistantmail-mcp 1.2.2 → 1.3.0

package/README.md

@@ -103,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. |
 
@@ -174,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,6 +1,6 @@
 {
   "name": "@assistantmail/assistantmail-mcp",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "AssistantMail MCP server",
   "repository": {
     "type": "git",

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.',