@adeu/mcp-server 1.12.0 → 1.13.0

package/dist/index.js

@@ -607,57 +607,59 @@ function removeNestedQuotes(text) {
 function getUniqueFilepath(saveDir, filename) {
   return join2(saveDir, filename);
 }
-async function search_and_fetch_emails(args) {
-  const apiKey = await getCloudAuthToken();
-  const maxAttachmentSizeMb = typeof args.max_attachment_size_mb === "number" && args.max_attachment_size_mb > 0 ? args.max_attachment_size_mb : 10;
-  let data;
-  if (args.task_id) {
-    const pollUrl = `${BACKEND_URL}/api/v1/emails/tasks/${args.task_id}`;
-    let completedData = null;
-    for (let attempt = 0; attempt < 10; attempt++) {
-      let res;
-      try {
-        res = await fetch(pollUrl, {
-          headers: {
-            Authorization: `Bearer ${apiKey}`,
-            Accept: "application/json"
-          },
-          signal: AbortSignal.timeout(15e3)
-        });
-      } catch (err) {
-        if (isTimeoutError(err)) {
-          throw new Error("Checking task status timed out.");
-        }
-        throw err;
-      }
-      if (res.status === 401) {
-        DesktopAuthManager.clearApiKey();
-        throw new Error(
-          "Authentication expired. Please call `login_to_adeu_cloud` to re-authenticate."
-        );
-      }
-      if (!res.ok) {
-        throw new Error(formatBackendError(res.status, await res.text()));
-      }
-      const taskData = await res.json();
-      const status = taskData.status;
-      if (status === "COMPLETED") {
-        completedData = taskData;
-        break;
-      }
-      if (status === "FAILED") {
-        const errorMsg = taskData.error || "Unknown internal error";
-        throw new Error(`Validation task failed on the server: ${errorMsg}`);
+async function pollEmailTask(taskId, apiKey) {
+  const pollUrl = `${BACKEND_URL}/api/v1/emails/tasks/${taskId}`;
+  for (let attempt = 0; attempt < 10; attempt++) {
+    let res;
+    try {
+      res = await fetch(pollUrl, {
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          Accept: "application/json"
+        },
+        signal: AbortSignal.timeout(15e3)
+      });
+    } catch (err) {
+      if (isTimeoutError(err)) {
+        throw new Error("Checking task status timed out.");
       }
-      await new Promise((resolve3) => setTimeout(resolve3, 5e3));
+      throw err;
     }
+    if (res.status === 401) {
+      DesktopAuthManager.clearApiKey();
+      throw new Error(
+        "Authentication expired. Please call `login_to_adeu_cloud` to re-authenticate."
+      );
+    }
+    if (!res.ok) {
+      throw new Error(formatBackendError(res.status, await res.text()));
+    }
+    const taskData = await res.json();
+    const status = taskData.status;
+    if (status === "COMPLETED") {
+      return taskData;
+    }
+    if (status === "FAILED") {
+      const errorMsg = taskData.error || "Unknown internal error";
+      throw new Error(`Validation task failed on the server: ${errorMsg}`);
+    }
+    await new Promise((resolve3) => setTimeout(resolve3, 5e3));
+  }
+  return null;
+}
+async function search_and_fetch_emails(args2) {
+  const apiKey = await getCloudAuthToken();
+  const maxAttachmentSizeMb = typeof args2.max_attachment_size_mb === "number" && args2.max_attachment_size_mb > 0 ? args2.max_attachment_size_mb : 10;
+  let data;
+  if (args2.task_id) {
+    const completedData = await pollEmailTask(args2.task_id, apiKey);
     if (!completedData) {
-      const msg = `Task ${args.task_id} is still processing. Please call \`search_and_fetch_emails\` again with task_id=${args.task_id}.`;
+      const msg = `Task ${args2.task_id} is still processing. Please call \`search_and_fetch_emails\` again with task_id=${args2.task_id}.`;
       return {
         content: [{ type: "text", text: msg }],
         structuredContent: {
           status: "pending",
-          task_id: args.task_id,
+          task_id: args2.task_id,
           message: msg
         }
       };
@@ -666,7 +668,7 @@ async function search_and_fetch_emails(args) {
   } else {
     let realEmailId;
     try {
-      realEmailId = args.email_id ? resolveEmailId(args.email_id) : void 0;
+      realEmailId = args2.email_id ? resolveEmailId(args2.email_id) : void 0;
     } catch (err) {
       if (err instanceof StaleShortIdError) {
         return {
@@ -678,16 +680,16 @@ async function search_and_fetch_emails(args) {
     }
     const payload = {
       email_id: realEmailId,
-      sender: args.sender,
-      subject: args.subject,
-      has_attachments: args.has_attachments,
-      attachment_name: args.attachment_name,
-      is_unread: args.is_unread,
-      days_ago: args.days_ago,
-      folder: args.folder,
-      limit: args.limit ?? 10,
-      offset: args.offset ?? 0,
-      mailbox_address: args.mailbox_address
+      sender: args2.sender,
+      subject: args2.subject,
+      has_attachments: args2.has_attachments,
+      attachment_name: args2.attachment_name,
+      is_unread: args2.is_unread,
+      days_ago: args2.days_ago,
+      folder: args2.folder,
+      limit: args2.limit ?? 10,
+      offset: args2.offset ?? 0,
+      mailbox_address: args2.mailbox_address
     };
     Object.keys(payload).forEach(
       (k) => payload[k] === void 0 && delete payload[k]
@@ -722,15 +724,19 @@ async function search_and_fetch_emails(args) {
     data = await res.json();
     if (res.status === 202 || data && (data.status === "pending" || data.task_id) && data.type === void 0) {
       const newTaskId = data.task_id;
-      const msg = `Email processing task started successfully. Task ID: ${newTaskId}. Please call \`search_and_fetch_emails\` again immediately with task_id=${newTaskId} to monitor the progress.`;
-      return {
-        content: [{ type: "text", text: msg }],
-        structuredContent: {
-          status: "pending",
-          task_id: String(newTaskId),
-          message: msg
-        }
-      };
+      const completedData = await pollEmailTask(String(newTaskId), apiKey);
+      if (!completedData) {
+        const msg = `Task ${newTaskId} is still processing. Please call \`search_and_fetch_emails\` again immediately with task_id=${newTaskId} to monitor the progress.`;
+        return {
+          content: [{ type: "text", text: msg }],
+          structuredContent: {
+            status: "pending",
+            task_id: String(newTaskId),
+            message: msg
+          }
+        };
+      }
+      data = completedData;
     }
   }
   const cache = loadIdCache();
@@ -763,8 +769,8 @@ async function search_and_fetch_emails(args) {
       );
     }
     saveIdCache(cache);
-    const limit = typeof args.limit === "number" ? args.limit : 10;
-    const offset = typeof args.offset === "number" ? args.offset : 0;
+    const limit = typeof args2.limit === "number" ? args2.limit : 10;
+    const offset = typeof args2.offset === "number" ? args2.offset : 0;
     const pageHint = previews.length >= limit ? `
 *(If you need to see more results, call this tool again with offset=${offset + limit})*` : "";
     lines.push(
@@ -779,11 +785,11 @@ async function search_and_fetch_emails(args) {
     const full = data.full_email || {};
     const shortTargetId = minifyEmailId(full.id || "unknown_id", cache);
     saveIdCache(cache);
-    const autoEscalated = !args.email_id && (args.sender !== void 0 || args.subject !== void 0 || args.has_attachments !== void 0 || args.attachment_name !== void 0 || args.is_unread !== void 0 || args.days_ago !== void 0 || args.folder !== void 0);
-    const baseDir = args.working_directory && existsSync2(args.working_directory) ? args.working_directory : tmpdir();
+    const autoEscalated = !args2.email_id && (args2.sender !== void 0 || args2.subject !== void 0 || args2.has_attachments !== void 0 || args2.attachment_name !== void 0 || args2.is_unread !== void 0 || args2.days_ago !== void 0 || args2.folder !== void 0);
+    const baseDir = args2.working_directory && existsSync2(args2.working_directory) ? args2.working_directory : tmpdir();
     const saveDir = join2(
       baseDir,
-      args.working_directory ? "adeu_attachments" : "adeu_downloads",
+      args2.working_directory ? "adeu_attachments" : "adeu_downloads",
       shortTargetId
     );
     mkdirSync2(saveDir, { recursive: true });
@@ -907,20 +913,20 @@ ${removeNestedQuotes(stripTags(histMsg.body_html || ""))}
     content: [{ type: "text", text: "Unknown response format from backend." }]
   };
 }
-async function create_email_draft(args) {
+async function create_email_draft(args2) {
   const apiKey = await getCloudAuthToken();
-  if (!args.reply_to_email_id && (!args.subject || !args.to_recipients)) {
+  if (!args2.reply_to_email_id && (!args2.subject || !args2.to_recipients)) {
     throw new Error(
       "You must provide either 'reply_to_email_id' OR both 'subject' and 'to_recipients'."
     );
   }
   const formData = new FormData();
-  formData.append("body_markdown", args.body_markdown);
-  if (args.reply_to_email_id) {
+  formData.append("body_markdown", args2.body_markdown);
+  if (args2.reply_to_email_id) {
     try {
       formData.append(
         "reply_to_email_id",
-        resolveEmailId(args.reply_to_email_id)
+        resolveEmailId(args2.reply_to_email_id)
       );
     } catch (err) {
       if (err instanceof StaleShortIdError) {
@@ -932,16 +938,16 @@ async function create_email_draft(args) {
       throw err;
     }
   }
-  if (args.subject) formData.append("subject", args.subject);
-  if (args.mailbox_address) {
-    formData.append("mailbox_address", args.mailbox_address);
+  if (args2.subject) formData.append("subject", args2.subject);
+  if (args2.mailbox_address) {
+    formData.append("mailbox_address", args2.mailbox_address);
   }
-  if (args.to_recipients) {
-    const recips = typeof args.to_recipients === "string" ? JSON.parse(args.to_recipients) : args.to_recipients;
+  if (args2.to_recipients) {
+    const recips = typeof args2.to_recipients === "string" ? JSON.parse(args2.to_recipients) : args2.to_recipients;
     formData.append("to_recipients", JSON.stringify(recips));
   }
-  if (args.attachment_paths) {
-    const paths = typeof args.attachment_paths === "string" ? JSON.parse(args.attachment_paths) : args.attachment_paths;
+  if (args2.attachment_paths) {
+    const paths = typeof args2.attachment_paths === "string" ? JSON.parse(args2.attachment_paths) : args2.attachment_paths;
     for (const p of paths) {
       const buf = readFileSync2(p);
       const filename = p.split(/[/\\]/).pop();
@@ -1053,7 +1059,18 @@ function readFileBytesOrThrow(filePath) {
   } catch (err) {
     if (err.code === "ENOENT") {
       throw new Error(
-        `File not found: ${filePath}. Note: If you are running in a sandboxed/containerized environment, the host application or MCP server may not have access to your local workspace files. You can resolve this by installing Adeu directly inside your sandboxed environment using 'uv tool install adeu' and executing the commands via the CLI.`
+        `File not found: ${filePath}.
+If you are running in a sandboxed/containerized environment (such as Claude Desktop or another containerized client), the host application or MCP server may not have direct access to your local workspace files.
+You can resolve this by installing and running the local 'adeu' CLI tool directly within your environment.
+Here is how the MCP tools map to their CLI equivalents:
+- read_docx               -> adeu extract ${filePath}
+- process_document_batch  -> adeu apply ${filePath}
+- diff_docx_files         -> adeu diff ${filePath} <modified_path>
+- accept_all_changes      -> adeu accept-all ${filePath}
+
+To run the local tool, install it via:
+  uv tool install adeu
+and run the mapped CLI command directly in your terminal.`
       );
     }
     throw err;
@@ -1072,9 +1089,13 @@ var READ_DOCX_TAIL = "Modes:\n- 'full' (default): paginated body content. Use pa
 var PROCESS_BATCH_COMMON_DESC = "Applies a batch of edits and review actions to a DOCX.\n\nAll changes evaluate against the ORIGINAL document state \u2014 do not chain dependent edits within one batch (e.g. rename X to Y, then modify Y). Apply the rename first, then send a second batch.\n\n";
 var PROCESS_BATCH_OPERATIONS_DESC = "Each item in `changes` must specify a `type`:\n1. 'modify': Search-and-replace. `target_text` must uniquely match \u2014 include surrounding context if the phrase is ambiguous. `new_text` supports Markdown: '# Heading 1' through '###### Heading 6', '**bold**', '_italic_', and '\\n\\n' to split into multiple paragraphs. Empty `new_text` deletes. Do NOT write CriticMarkup tags ({++, {--, {>>) manually \u2014 use the `comment` parameter for comments.\n2. 'accept' / 'reject': Finalize or revert a tracked change by `target_id` (e.g. 'Chg:12').\n3. 'reply': Reply to a comment by `target_id` (e.g. 'Com:5') with `text`.\n4. 'insert_row' / 'delete_row': Table edits. Disk mode only \u2014 not supported on Live Word canvas.\n\nID VOLATILITY: 'Chg:N' and 'Com:N' shift between document states. Always call `read_docx` immediately before any accept/reject/reply \u2014 do not reuse IDs from earlier in the conversation.\n\n`author_name` is used for attribution on all tracked changes and comments, in both disk and Live Word modes.";
 var DIFF_DOCX_DESC = "Compares two DOCX files and returns a unified diff of their text content. Useful for analyzing differences between versions before editing.";
-var gitSha = "893d263";
-var packageVersion = "1.12.0";
+var gitSha = "cab9a8d";
+var packageVersion = "1.13.0";
 var buildTag = ` [Adeu v${packageVersion}+${gitSha}]`;
+var args = process.argv.slice(2);
+var scopeIdx = args.indexOf("--scope");
+var requestedScope = (scopeIdx !== -1 ? args[scopeIdx + 1] : "all").toLowerCase();
+var isDocxOnly = requestedScope === "docx";
 var server = new McpServer({
   name: "adeu-redlining-service",
   version: packageVersion
@@ -1221,43 +1242,6 @@ registerAppTool(
     }
   }
 );
-registerAppTool(
-  server,
-  "search_and_fetch_emails",
-  {
-    title: "Search & Fetch Emails",
-    description: "Searches the user's live email inbox via the Adeu cloud backend.\n\nTWO MODES:\n1. Search mode (no `email_id`): returns up to `limit` lightweight previews. Use filters (`sender`, `subject`, `is_unread`, `days_ago`, `folder`, `has_attachments`, `attachment_name`) to narrow down.\n2. Fetch mode (with `email_id`): returns the full email body, thread history, and downloads attachments under `max_attachment_size_mb` to the local disk.\n\nAUTO-ESCALATION: If a search returns exactly one preview, the backend automatically fetches the full email in the same call. Plan around the response shape \u2014 check the `type` field (`previews` vs `full_email`) before assuming.\n\nEMAIL ID FORMATS (`email_id` parameter accepts any of):\n- `msg_<6 chars>` \u2014 short ID returned by previews on THIS machine. NOT portable across machines or sessions; the local cache holds the most recent 1000. If you reference one that's been evicted, the tool returns a StaleShortIdError telling you to re-search.\n- `adeu_<numeric>` \u2014 server-side reference for emails Adeu has previously processed. Portable across machines and sessions for the same authenticated user.\n- Raw provider ID (Gmail/Outlook native ID) \u2014 works if you have it, but you usually won't.\n\nFOLDER DEFAULT: omitting `folder` searches the Inbox only (matching what the user sees in their mail client). Use `folder='sent'` for sent items, `folder='all'` to include Deleted Items, Drafts, and other folders.\n\nATTACHMENTS: attachments larger than `max_attachment_size_mb` (default 10) are listed in the response but NOT downloaded \u2014 raise the cap if you need them. Always set `working_directory` when calling from a project so attachments land alongside the user's other files.",
-    inputSchema: z.object({
-      sender: z.string().optional(),
-      subject: z.string().optional(),
-      has_attachments: z.boolean().optional(),
-      attachment_name: z.string().optional(),
-      is_unread: z.boolean().optional(),
-      days_ago: z.number().optional(),
-      folder: z.enum(["inbox", "sent", "all"]).optional(),
-      limit: z.number().default(10),
-      offset: z.number().default(0),
-      email_id: z.string().optional(),
-      working_directory: z.string().optional(),
-      mailbox_address: z.string().optional().describe("Optional target mailbox email address to search within."),
-      task_id: z.string().optional().describe("If resuming a pending check, provide the task ID here."),
-      max_attachment_size_mb: z.number().optional().describe(
-        "Maximum attachment size in MB to download (default 10). Attachments larger than this are listed in the response but not downloaded. Raise this to fetch large files."
-      )
-    }),
-    _meta: { ui: { resourceUri: EMAIL_UI_URI } }
-  },
-  async (args) => {
-    try {
-      return await search_and_fetch_emails(args);
-    } catch (e) {
-      return {
-        isError: true,
-        content: [{ type: "text", text: e.message }]
-      };
-    }
-  }
-);
 server.registerTool(
   "process_document_batch",
   {
@@ -1468,67 +1452,106 @@ ${result.reportText}`
     }
   }
 );
-server.registerTool(
-  "login_to_adeu_cloud",
-  {
-    description: "Logs the user into Adeu Cloud. Opens a browser window for SSO authentication.\n\nIMPORTANT \u2014 login is user-level, not account-level:\n- An Adeu user can have multiple linked provider accounts (Microsoft, Google) and multiple mailboxes (personal + shared/delegated). One linked account is marked primary.\n- Signing in through ANY of the user's linked accounts authenticates the same Adeu user. Once logged in, the session can read from and draft in ALL of that user's linked accounts and ALL of their mailboxes \u2014 not just the one used to sign in.\n- The choice of which provider account to sign in through is purely an SSO mechanism; it does not select a 'current account' for the session.\n\nWhen the user asks which accounts or mailboxes are available, call `list_available_mailboxes` rather than naming a single account from the login response."
-  },
-  async () => {
-    try {
-      return await login_to_adeu_cloud();
-    } catch (e) {
-      return { isError: true, content: [{ type: "text", text: e.message }] };
+if (!isDocxOnly) {
+  registerAppTool(
+    server,
+    "search_and_fetch_emails",
+    {
+      title: "Search & Fetch Emails",
+      description: "Searches the user's live email inbox via the Adeu cloud backend.\n\nTWO MODES:\n1. Search mode (no `email_id`): returns up to `limit` lightweight previews. Use filters (`sender`, `subject`, `is_unread`, `days_ago`, `folder`, `has_attachments`, `attachment_name`) to narrow down.\n2. Fetch mode (with `email_id`): returns the full email body, thread history, and downloads attachments under `max_attachment_size_mb` to the local disk.\n\nAUTO-ESCALATION: If a search returns exactly one preview, the backend automatically fetches the full email in the same call. Plan around the response shape \u2014 check the `type` field (`previews` vs `full_email`) before assuming.\n\nEMAIL ID FORMATS (`email_id` parameter accepts any of):\n- `msg_<6 chars>` \u2014 short ID returned by previews on THIS machine. NOT portable across machines or sessions; the local cache holds the most recent 1000. If you reference one that's been evicted, the tool returns a StaleShortIdError telling you to re-search.\n- `adeu_<numeric>` \u2014 server-side reference for emails Adeu has previously processed. Portable across machines and sessions for the same authenticated user.\n- Raw provider ID (Gmail/Outlook native ID) \u2014 works if you have it, but you usually won't.\n\nFOLDER DEFAULT: omitting `folder` searches the Inbox only (matching what the user sees in their mail client). Use `folder='sent'` for sent items, `folder='all'` to include Deleted Items, Drafts, and other folders.\n\nATTACHMENTS: attachments larger than `max_attachment_size_mb` (default 10) are listed in the response but NOT downloaded \u2014 raise the cap if you need them. Always set `working_directory` when calling from a project so attachments land alongside the user's other files.",
+      inputSchema: z.object({
+        sender: z.string().optional(),
+        subject: z.string().optional(),
+        has_attachments: z.boolean().optional(),
+        attachment_name: z.string().optional(),
+        is_unread: z.boolean().optional(),
+        days_ago: z.number().optional(),
+        folder: z.enum(["inbox", "sent", "all"]).optional(),
+        limit: z.number().default(10),
+        offset: z.number().default(0),
+        email_id: z.string().optional(),
+        working_directory: z.string().optional(),
+        mailbox_address: z.string().optional().describe("Optional target mailbox email address to search within."),
+        task_id: z.string().optional().describe("If resuming a pending check, provide the task ID here."),
+        max_attachment_size_mb: z.number().optional().describe(
+          "Maximum attachment size in MB to download (default 10). Attachments larger than this are listed in the response but not downloaded. Raise this to fetch large files."
+        )
+      }),
+      _meta: { ui: { resourceUri: EMAIL_UI_URI } }
+    },
+    async (args2) => {
+      try {
+        return await search_and_fetch_emails(args2);
+      } catch (e) {
+        return {
+          isError: true,
+          content: [{ type: "text", text: e.message }]
+        };
+      }
     }
-  }
-);
-server.registerTool(
-  "logout_of_adeu_cloud",
-  { description: "Logs out of the Adeu Cloud backend." },
-  async () => {
-    try {
-      return await logout_of_adeu_cloud();
-    } catch (e) {
-      return { isError: true, content: [{ type: "text", text: e.message }] };
+  );
+  server.registerTool(
+    "login_to_adeu_cloud",
+    {
+      description: "Logs the user into Adeu Cloud. Opens a browser window for SSO authentication.\n\nIMPORTANT \u2014 login is user-level, not account-level:\n- An Adeu user can have multiple linked provider accounts (Microsoft, Google) and multiple mailboxes (personal + shared/delegated). One linked account is marked primary.\n- Signing in through ANY of the user's linked accounts authenticates the same Adeu user. Once logged in, the session can read from and draft in ALL of that user's linked accounts and ALL of their mailboxes \u2014 not just the one used to sign in.\n- The choice of which provider account to sign in through is purely an SSO mechanism; it does not select a 'current account' for the session.\n\nWhen the user asks which accounts or mailboxes are available, call `list_available_mailboxes` rather than naming a single account from the login response."
+    },
+    async () => {
+      try {
+        return await login_to_adeu_cloud();
+      } catch (e) {
+        return { isError: true, content: [{ type: "text", text: e.message }] };
+      }
     }
-  }
-);
-server.registerTool(
-  "create_email_draft",
-  {
-    description: "Creates an email draft in the user's native draft box (Outlook Drafts or Gmail Drafts).\n\nTWO MODES:\n1. Reply mode: pass `reply_to_email_id` to create a threaded reply. The draft inherits subject, recipients, and threading headers from the original \u2014 do NOT pass `subject` or `to_recipients`.\n2. New email mode: omit `reply_to_email_id` and pass BOTH `subject` and `to_recipients`.\n\n`reply_to_email_id` accepts the same ID formats as search_and_fetch_emails (`msg_*` short IDs, `adeu_*` references, or raw provider IDs). Short IDs are validated against the local cache before the call; stale ones fail fast with a clear error telling you to re-search.\n\n`body_markdown` is converted server-side to styled HTML with inlined CSS for email-client compatibility. Write the body in plain Markdown \u2014 do not pre-render HTML.\n\n`attachment_paths` takes absolute file paths on the user's local disk and uploads them with the draft. Useful right after search_and_fetch_emails downloaded attachments \u2014 those local paths can be passed directly here.",
-    inputSchema: {
-      body_markdown: z.string(),
-      reply_to_email_id: z.string().optional(),
-      subject: z.string().optional(),
-      to_recipients: z.array(z.string()).optional(),
-      attachment_paths: z.array(z.string()).optional(),
-      mailbox_address: z.string().optional().describe(
-        "Optional target mailbox email address to create the draft in."
-      )
+  );
+  server.registerTool(
+    "logout_of_adeu_cloud",
+    { description: "Logs out of the Adeu Cloud backend." },
+    async () => {
+      try {
+        return await logout_of_adeu_cloud();
+      } catch (e) {
+        return { isError: true, content: [{ type: "text", text: e.message }] };
+      }
     }
-  },
-  async (args) => {
-    try {
-      return await create_email_draft(args);
-    } catch (e) {
-      return { isError: true, content: [{ type: "text", text: e.message }] };
+  );
+  server.registerTool(
+    "create_email_draft",
+    {
+      description: "Creates an email draft in the user's native draft box (Outlook Drafts or Gmail Drafts).\n\nTWO MODES:\n1. Reply mode: pass `reply_to_email_id` to create a threaded reply. The draft inherits subject, recipients, and threading headers from the original \u2014 do NOT pass `subject` or `to_recipients`.\n2. New email mode: omit `reply_to_email_id` and pass BOTH `subject` and `to_recipients`.\n\n`reply_to_email_id` accepts the same ID formats as search_and_fetch_emails (`msg_*` short IDs, `adeu_*` references, or raw provider IDs). Short IDs are validated against the local cache before the call; stale ones fail fast with a clear error telling you to re-search.\n\n`body_markdown` is converted server-side to styled HTML with inlined CSS for email-client compatibility. Write the body in plain Markdown \u2014 do not pre-render HTML.\n\n`attachment_paths` takes absolute file paths on the user's local disk and uploads them with the draft. Useful right after search_and_fetch_emails downloaded attachments \u2014 those local paths can be passed directly here.",
+      inputSchema: {
+        body_markdown: z.string(),
+        reply_to_email_id: z.string().optional(),
+        subject: z.string().optional(),
+        to_recipients: z.array(z.string()).optional(),
+        attachment_paths: z.array(z.string()).optional(),
+        mailbox_address: z.string().optional().describe(
+          "Optional target mailbox email address to create the draft in."
+        )
+      }
+    },
+    async (args2) => {
+      try {
+        return await create_email_draft(args2);
+      } catch (e) {
+        return { isError: true, content: [{ type: "text", text: e.message }] };
+      }
     }
-  }
-);
-server.registerTool(
-  "list_available_mailboxes",
-  {
-    description: "Lists all personal and shared/delegated mailboxes the authenticated Adeu user has access to, across ALL of their linked provider accounts. Returns each mailbox's `email_address`, `display_name`, auto-processing settings, and write-back preference.\n\nThis is the right tool to answer 'which accounts/mailboxes am I logged into?' \u2014 Adeu login is user-level, so a single MCP session can see every mailbox listed here regardless of which provider account was used for SSO.\n\nCall this FIRST when the user names a specific mailbox or shared inbox, to resolve the canonical `email_address`. Then pass that address as `mailbox_address` to `search_and_fetch_emails` or `create_email_draft` to scope the operation. Omitting `mailbox_address` on those tools targets the user's primary personal mailbox.",
-    inputSchema: {}
-  },
-  async () => {
-    try {
-      return await list_available_mailboxes();
-    } catch (e) {
-      return { isError: true, content: [{ type: "text", text: e.message }] };
+  );
+  server.registerTool(
+    "list_available_mailboxes",
+    {
+      description: "Lists all personal and shared/delegated mailboxes the authenticated Adeu user has access to, across ALL of their linked provider accounts. Returns each mailbox's `email_address`, `display_name`, auto-processing settings, and write-back preference.\n\nThis is the right tool to answer 'which accounts/mailboxes am I logged into?' \u2014 Adeu login is user-level, so a single MCP session can see every mailbox listed here regardless of which provider account was used for SSO.\n\nCall this FIRST when the user names a specific mailbox or shared inbox, to resolve the canonical `email_address`. Then pass that address as `mailbox_address` to `search_and_fetch_emails` or `create_email_draft` to scope the operation. Omitting `mailbox_address` on those tools targets the user's primary personal mailbox.",
+      inputSchema: {}
+    },
+    async () => {
+      try {
+        return await list_available_mailboxes();
+      } catch (e) {
+        return { isError: true, content: [{ type: "text", text: e.message }] };
+      }
     }
-  }
-);
+  );
+}
 function formatBatchResult(stats, outPath, dry_run) {
   let res = "";
   if (dry_run) {
@@ -1582,8 +1605,8 @@ ${stats.skipped_details.join("\n")}`;
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  const gitSha2 = "893d263";
-  const buildTs = "2026-06-18T14:35:42.322Z";
+  const gitSha2 = "cab9a8d";
+  const buildTs = "2026-06-23T13:51:25.626Z";
   console.error(
     `Adeu MCP Server (Node.js Engine: ${identifyEngine()}) running on stdio build=${gitSha2}@${buildTs}`
   );