@mindstone/mcp-server-microsoft-mail 0.1.0

package/dist/mail.js

@@ -0,0 +1,233 @@
+const WELL_KNOWN_FOLDERS = {
+    inbox: 'inbox',
+    'sent items': 'sentitems',
+    sent: 'sentitems',
+    'deleted items': 'deleteditems',
+    trash: 'deleteditems',
+    'junk email': 'junkemail',
+    junk: 'junkemail',
+    spam: 'junkemail',
+    drafts: 'drafts',
+    archive: 'archive',
+    outbox: 'outbox',
+};
+export function resolveFolder(folder) {
+    const trimmed = folder.trim();
+    return WELL_KNOWN_FOLDERS[trimmed.toLowerCase()] ?? trimmed;
+}
+function ensureArray(value) {
+    if (value == null)
+        return undefined;
+    return Array.isArray(value) ? value : [value];
+}
+export async function listEmails(client, args, signal) {
+    const folder = resolveFolder(args.folder ?? 'Inbox');
+    const top = Math.min(args.top ?? 25, 100);
+    let endpoint = `/me/mailFolders/${folder}/messages`;
+    const queryParams = [
+        `$top=${top}`,
+        '$select=id,subject,from,receivedDateTime,bodyPreview,isRead,hasAttachments,importance',
+        '$orderby=receivedDateTime desc',
+    ];
+    if (args.filter) {
+        queryParams.push(`$filter=${args.filter}`);
+    }
+    endpoint += '?' + queryParams.join('&');
+    const response = await client.api(endpoint).options({ signal }).get();
+    const emails = response.value ?? [];
+    const formatted = emails.map((email) => ({
+        id: email.id,
+        subject: email.subject,
+        from: email.from?.emailAddress?.address,
+        fromName: email.from?.emailAddress?.name,
+        receivedAt: email.receivedDateTime,
+        preview: email.bodyPreview?.substring(0, 200),
+        isRead: email.isRead,
+        hasAttachments: email.hasAttachments,
+        importance: email.importance,
+    }));
+    return {
+        count: formatted.length,
+        folder,
+        emails: formatted,
+    };
+}
+export async function getEmail(client, args, signal) {
+    const email = await client
+        .api(`/me/messages/${args.id}`)
+        .options({ signal })
+        .select('id,subject,from,toRecipients,ccRecipients,receivedDateTime,body,isRead,hasAttachments,importance')
+        .get();
+    return {
+        id: email.id,
+        subject: email.subject,
+        from: email.from?.emailAddress,
+        to: email.toRecipients?.map((r) => r.emailAddress),
+        cc: email.ccRecipients?.map((r) => r.emailAddress),
+        receivedAt: email.receivedDateTime,
+        body: email.body?.content,
+        bodyType: email.body?.contentType,
+        isRead: email.isRead,
+        hasAttachments: email.hasAttachments,
+        importance: email.importance,
+    };
+}
+export async function sendEmail(client, args, signal) {
+    const toList = ensureArray(args.to) ?? [];
+    const ccList = ensureArray(args.cc);
+    const message = {
+        subject: args.subject,
+        body: {
+            contentType: args.body.includes('<') ? 'HTML' : 'Text',
+            content: args.body,
+        },
+        toRecipients: toList.map((email) => ({
+            emailAddress: { address: email },
+        })),
+        ccRecipients: ccList?.map((email) => ({
+            emailAddress: { address: email },
+        })),
+        importance: args.importance ?? 'normal',
+    };
+    await client.api('/me/sendMail').options({ signal }).post({ message });
+    return {
+        success: true,
+        message: `Email sent to ${toList.join(', ')}`,
+    };
+}
+export async function searchEmails(client, args, signal) {
+    const top = Math.min(args.top ?? 25, 100);
+    // Note: Microsoft Graph API does not support $orderBy with $search.
+    // Search results are automatically sorted by date (newest first).
+    const response = await client
+        .api('/me/messages')
+        .options({ signal })
+        .search(`"${args.query}"`)
+        .top(top)
+        .select('id,subject,from,receivedDateTime,bodyPreview,isRead')
+        .get();
+    const emails = response.value ?? [];
+    const formatted = emails.map((email) => ({
+        id: email.id,
+        subject: email.subject,
+        from: email.from?.emailAddress?.address,
+        receivedAt: email.receivedDateTime,
+        preview: email.bodyPreview?.substring(0, 200),
+        isRead: email.isRead,
+    }));
+    return {
+        query: args.query,
+        count: formatted.length,
+        emails: formatted,
+    };
+}
+export async function replyToEmail(client, args, signal) {
+    const endpoint = args.replyAll
+        ? `/me/messages/${args.id}/replyAll`
+        : `/me/messages/${args.id}/reply`;
+    await client.api(endpoint).options({ signal }).post({
+        comment: args.body,
+    });
+    return {
+        success: true,
+        message: args.replyAll ? 'Reply sent to all recipients' : 'Reply sent',
+    };
+}
+export async function forwardEmail(client, args, signal) {
+    const toList = ensureArray(args.to) ?? [];
+    await client.api(`/me/messages/${args.id}/forward`).options({ signal }).post({
+        comment: args.comment ?? '',
+        toRecipients: toList.map((email) => ({
+            emailAddress: { address: email },
+        })),
+    });
+    return {
+        success: true,
+        message: `Email forwarded to ${toList.join(', ')}`,
+    };
+}
+export async function deleteEmail(client, args, signal) {
+    if (args.permanent) {
+        await client.api(`/me/messages/${args.id}`).options({ signal }).delete();
+        return { success: true, message: 'Email permanently deleted' };
+    }
+    await client.api(`/me/messages/${args.id}/move`).options({ signal }).post({
+        destinationId: 'deleteditems',
+    });
+    return { success: true, message: 'Email moved to Deleted Items' };
+}
+export async function listFolders(client, args, signal) {
+    let endpoint = '/me/mailFolders';
+    if (!args.includeHidden) {
+        endpoint += '?$filter=isHidden eq false';
+    }
+    const response = await client.api(endpoint).options({ signal }).get();
+    const folders = response.value ?? [];
+    const formatted = folders.map((folder) => ({
+        id: folder.id,
+        name: folder.displayName,
+        totalItems: folder.totalItemCount,
+        unreadItems: folder.unreadItemCount,
+        childFolders: folder.childFolderCount,
+    }));
+    return {
+        count: formatted.length,
+        folders: formatted,
+    };
+}
+export async function moveEmail(client, args, signal) {
+    const folderId = resolveFolder(args.destinationFolder);
+    await client.api(`/me/messages/${args.id}/move`).options({ signal }).post({
+        destinationId: folderId,
+    });
+    return {
+        success: true,
+        message: `Email moved to ${args.destinationFolder}`,
+    };
+}
+export async function createReplyDraft(client, args, signal) {
+    const endpoint = args.replyAll
+        ? `/me/messages/${args.id}/createReplyAll`
+        : `/me/messages/${args.id}/createReply`;
+    const requestBody = {};
+    if (args.body) {
+        requestBody.message = {
+            body: {
+                contentType: args.body.includes('<') ? 'HTML' : 'Text',
+                content: args.body,
+            },
+        };
+    }
+    const response = await client.api(endpoint).options({ signal }).post(requestBody);
+    return {
+        success: true,
+        draftId: response.id,
+        conversationId: response.conversationId,
+        subject: response.subject,
+        message: `Reply draft created${args.replyAll ? ' (reply-all)' : ''}. Open Outlook to review and send.`,
+    };
+}
+export async function createDraft(client, args, signal) {
+    const toList = ensureArray(args.to);
+    const ccList = ensureArray(args.cc);
+    const draft = {
+        subject: args.subject,
+        body: {
+            contentType: args.body.includes('<') ? 'HTML' : 'Text',
+            content: args.body,
+        },
+        toRecipients: toList?.map((email) => ({
+            emailAddress: { address: email },
+        })),
+        ccRecipients: ccList?.map((email) => ({
+            emailAddress: { address: email },
+        })),
+    };
+    const response = await client.api('/me/messages').options({ signal }).post(draft);
+    return {
+        success: true,
+        draftId: response.id,
+        message: 'Draft created successfully',
+    };
+}
+//# sourceMappingURL=mail.js.map

package/dist/mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.js","sourceRoot":"","sources":["../src/mail.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,wBAAgB,YAAY,IAAI,SAAS,CAOxC"}

package/dist/server.js

@@ -0,0 +1,12 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SERVER_NAME, SERVER_VERSION } from './types.js';
+import { registerMailTools } from './tools.js';
+export function createServer() {
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    registerMailTools(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IACH,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerMailTools(server: McpServer): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2CzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiczD"}

package/dist/tools.js

@@ -0,0 +1,359 @@
+import { z } from 'zod';
+import { callGraph } from './client.js';
+import { authRequiredJson, errorResponse, successJson, withErrorHandling, } from './utils.js';
+import { AUTH_TOOL_NAME } from './types.js';
+import { createDraft, createReplyDraft, deleteEmail, forwardEmail, getEmail, listEmails, listFolders, moveEmail, replyToEmail, searchEmails, sendEmail, } from './mail.js';
+const RecipientField = z.union([z.array(z.string()), z.string()]);
+const ImportanceEnum = z.enum(['low', 'normal', 'high']);
+// send_email accepts unknown keys so the handler can surface bundled-parity
+// alias guidance (`recipient`/`recipients`, `message`/`content`/`text`)
+// rather than letting Zod silently strip them.
+const SendEmailSchema = z
+    .object({
+    to: RecipientField.optional().describe('Recipient email address(es). Use an array: ["alice@example.com"]'),
+    subject: z.string().optional().describe('Email subject'),
+    body: z.string().optional().describe('Email body (HTML supported)'),
+    cc: RecipientField.optional().describe('CC recipient(s)'),
+    importance: ImportanceEnum.optional().describe('Email importance'),
+})
+    .passthrough();
+export function registerMailTools(server) {
+    // ---------------------------------------------------------------------
+    // authenticate_microsoft_account
+    // ---------------------------------------------------------------------
+    server.registerTool(AUTH_TOOL_NAME, {
+        description: `Connect a Microsoft 365 account to enable email, calendar, files, and Teams access.
+
+Call this tool when:
+1. Other Microsoft tools return authentication errors
+2. The user asks to connect or set up Microsoft 365
+
+This tool returns a structured auth_required response. The host will
+recognise it and dispatch the desktop OAuth flow. After the user completes
+sign-in, Microsoft 365 tools become available.`,
+        inputSchema: z.object({}).strict().shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+    }, withErrorHandling(async () => authRequiredJson()));
+    // ---------------------------------------------------------------------
+    // list_emails
+    // ---------------------------------------------------------------------
+    server.registerTool('list_emails', {
+        description: 'List emails from inbox or a specific folder. Returns subject, sender, date, and preview.',
+        inputSchema: z.object({
+            folder: z
+                .string()
+                .optional()
+                .describe('Well-known folder name (inbox, sentitems, drafts, deleteditems, junkemail, archive, outbox), display name (e.g. "Sent Items"), or folder ID from list_folders. Default: Inbox.'),
+            top: z.number().optional().describe('Number of emails to return (default: 25, max: 100)'),
+            filter: z
+                .string()
+                .optional()
+                .describe('OData filter expression (e.g., "isRead eq false")'),
+        }).shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        const result = await callGraph(extra, (c, signal) => listEmails(c, args, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // get_email
+    // ---------------------------------------------------------------------
+    server.registerTool('get_email', {
+        description: 'Get full email content including body by message ID.',
+        inputSchema: z.object({
+            id: z.string().optional().describe('Email message ID'),
+        }).shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        if (!args.id) {
+            return errorResponse({
+                error: 'Missing required parameter: "id" (the email message ID). Example: { "id": "AAMkAGI2..." }. Use list_emails to find message IDs.',
+                action_required: 'Provide the message ID returned by list_emails.',
+                next_step: 'list_emails',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => getEmail(c, { id: args.id }, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // send_email
+    // ---------------------------------------------------------------------
+    server.registerTool('send_email', {
+        description: 'Send a new email message. "to" and "cc" accept a string or an array of strings. Prefer arrays for multiple recipients (e.g. ["alice@example.com"]).',
+        inputSchema: SendEmailSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        if ('recipient' in args || 'recipients' in args) {
+            return errorResponse({
+                error: 'Invalid parameter: Use "to" instead of "recipient"/"recipients". Example: { "to": ["alice@example.com"], "subject": "Hello", "body": "Message content" }',
+                action_required: 'Use the "to" parameter (string or array of strings).',
+                next_step: 'send_email',
+            });
+        }
+        if ('message' in args || 'content' in args || 'text' in args) {
+            return errorResponse({
+                error: 'Invalid parameter: Use "body" instead of "message"/"content"/"text". Example: { "to": ["alice@example.com"], "subject": "Hello", "body": "Message content" }',
+                action_required: 'Use the "body" parameter to provide the email content.',
+                next_step: 'send_email',
+            });
+        }
+        const toList = Array.isArray(args.to) ? args.to : args.to ? [args.to] : [];
+        if (!toList.length || !args.subject || !args.body) {
+            return errorResponse({
+                error: 'Missing required parameters. Required: "to" (string or array), "subject" (string), "body" (string). Example: { "to": ["recipient@example.com"], "subject": "Meeting Tomorrow", "body": "Hi, let\'s meet at 3pm." }',
+                action_required: 'Provide to, subject, and body fields.',
+                next_step: 'send_email',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => sendEmail(c, {
+            to: args.to,
+            subject: args.subject,
+            body: args.body,
+            cc: args.cc,
+            importance: args.importance,
+        }, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // search_emails
+    // ---------------------------------------------------------------------
+    server.registerTool('search_emails', {
+        description: 'Search emails using Microsoft Search query syntax.',
+        inputSchema: z.object({
+            query: z
+                .string()
+                .optional()
+                .describe('Search query (e.g., "from:john subject:meeting")'),
+            top: z.number().optional().describe('Number of results (default: 25)'),
+        }).shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        if (!args.query) {
+            return errorResponse({
+                error: 'Missing required parameter: "query" (search text). Example: { "query": "project update", "top": 20 }',
+                action_required: 'Provide a non-empty query string.',
+                next_step: 'search_emails',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => searchEmails(c, { query: args.query, top: args.top }, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // reply_to_email
+    // ---------------------------------------------------------------------
+    server.registerTool('reply_to_email', {
+        description: 'Reply to an email message.',
+        inputSchema: z.object({
+            id: z.string().optional().describe('Original email message ID'),
+            body: z.string().optional().describe('Reply body (HTML supported)'),
+            replyAll: z
+                .boolean()
+                .optional()
+                .describe('Reply to all recipients (default: false)'),
+        }).shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        if (!args.id || !args.body) {
+            return errorResponse({
+                error: 'Missing required parameters: "id" (email to reply to) and "body" (reply content). Example: { "id": "AAMkAGI2...", "body": "Thanks for your message!", "replyAll": false }',
+                action_required: 'Provide both id and body.',
+                next_step: 'reply_to_email',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => replyToEmail(c, { id: args.id, body: args.body, replyAll: args.replyAll }, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // forward_email
+    // ---------------------------------------------------------------------
+    server.registerTool('forward_email', {
+        description: 'Forward an email to other recipients.',
+        inputSchema: z.object({
+            id: z.string().optional().describe('Email message ID to forward'),
+            to: RecipientField.optional().describe('Recipient(s) to forward to'),
+            comment: z.string().optional().describe('Optional comment to add'),
+        }).shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        const toList = Array.isArray(args.to) ? args.to : args.to ? [args.to] : [];
+        if (!args.id || !toList.length) {
+            return errorResponse({
+                error: 'Missing required parameters: "id" (email to forward) and "to" (string or array). Example: { "id": "AAMkAGI2...", "to": ["colleague@example.com"], "comment": "FYI" }',
+                action_required: 'Provide both id and to.',
+                next_step: 'forward_email',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => forwardEmail(c, { id: args.id, to: args.to, comment: args.comment }, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // delete_email
+    // ---------------------------------------------------------------------
+    server.registerTool('delete_email', {
+        description: 'Delete or move an email to trash.',
+        inputSchema: z.object({
+            id: z.string().optional().describe('Email message ID'),
+            permanent: z
+                .boolean()
+                .optional()
+                .describe('Permanently delete (default: false, moves to Deleted Items)'),
+        }).shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        if (!args.id) {
+            return errorResponse({
+                error: 'Missing required parameter: "id" (email to delete). Example: { "id": "AAMkAGI2...", "permanent": false }. Set "permanent": true to permanently delete instead of moving to Deleted Items.',
+                action_required: 'Provide the message ID.',
+                next_step: 'delete_email',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => deleteEmail(c, { id: args.id, permanent: args.permanent }, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // list_folders
+    // ---------------------------------------------------------------------
+    server.registerTool('list_folders', {
+        description: 'List mail folders (Inbox, Sent, Drafts, etc.). Returns folder IDs that can be used with list_emails and move_email.',
+        inputSchema: z.object({
+            includeHidden: z
+                .boolean()
+                .optional()
+                .describe('Include hidden folders (default: false)'),
+        }).shape,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        const result = await callGraph(extra, (c, signal) => listFolders(c, args, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // move_email
+    // ---------------------------------------------------------------------
+    server.registerTool('move_email', {
+        description: 'Move an email to a different folder.',
+        inputSchema: z.object({
+            id: z.string().optional().describe('Email message ID'),
+            destinationFolder: z
+                .string()
+                .optional()
+                .describe('Well-known folder name (inbox, sentitems, drafts, deleteditems, junkemail, archive, outbox), display name, or folder ID from list_folders'),
+        }).shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        if (!args.id || !args.destinationFolder) {
+            return errorResponse({
+                error: 'Missing required parameters: "id" (email to move) and "destinationFolder" (target folder). Example: { "id": "AAMkAGI2...", "destinationFolder": "inbox" }. Use list_folders to find folder IDs.',
+                action_required: 'Provide id and destinationFolder.',
+                next_step: 'list_folders',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => moveEmail(c, { id: args.id, destinationFolder: args.destinationFolder }, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // create_reply_draft
+    // ---------------------------------------------------------------------
+    server.registerTool('create_reply_draft', {
+        description: 'Create a draft reply to an existing email, threaded in the same conversation. The draft is saved in Drafts and can be reviewed in Outlook before sending.',
+        inputSchema: z.object({
+            id: z.string().optional().describe('Original email message ID to reply to'),
+            body: z
+                .string()
+                .optional()
+                .describe('Reply body (HTML supported). If omitted, creates a blank reply draft.'),
+            replyAll: z
+                .boolean()
+                .optional()
+                .describe('Reply to all recipients (default: false)'),
+        }).shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        if (!args.id) {
+            return errorResponse({
+                error: 'Missing required parameter: "id" (the email message ID to reply to). Example: { "id": "AAMkAGI2...", "body": "Thanks for your message!" }',
+                action_required: 'Provide the message ID.',
+                next_step: 'list_emails',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => createReplyDraft(c, { id: args.id, body: args.body, replyAll: args.replyAll }, signal));
+        return successJson(result);
+    }));
+    // ---------------------------------------------------------------------
+    // create_draft
+    // ---------------------------------------------------------------------
+    server.registerTool('create_draft', {
+        description: 'Create a new standalone draft email (saved but not sent). For replying to an existing thread, use create_reply_draft instead.',
+        inputSchema: z.object({
+            to: RecipientField.optional().describe('Recipient email address(es)'),
+            subject: z.string().optional().describe('Email subject'),
+            body: z.string().optional().describe('Email body (HTML supported)'),
+            cc: RecipientField.optional().describe('CC recipient(s)'),
+        }).shape,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+    }, withErrorHandling(async (args, extra) => {
+        if (!args.subject || !args.body) {
+            return errorResponse({
+                error: 'Missing required parameters: "subject" and "body". Example: { "to": ["recipient@example.com"], "subject": "Draft Email", "body": "Content here..." }',
+                action_required: 'Provide subject and body.',
+                next_step: 'create_draft',
+            });
+        }
+        const result = await callGraph(extra, (c, signal) => createDraft(c, {
+            to: args.to,
+            subject: args.subject,
+            body: args.body,
+            cc: args.cc,
+        }, signal));
+        return successJson(result);
+    }));
+}
+//# sourceMappingURL=tools.js.map