@jbctechsolutions/mcp-outlook-mac 1.3.0 → 1.4.0

package/dist/index.js

@@ -26,7 +26,8 @@ import { createContactsTools } from './tools/contacts.js';
 import { createTasksTools } from './tools/tasks.js';
 import { createNotesTools } from './tools/notes.js';
 import { createMailboxOrganizationTools } from './tools/mailbox-organization.js';
-import { createMailSendTools } from './tools/mail-send.js';
+import { createMailSendTools, SetSignatureInput, GetSignatureInput, } from './tools/mail-send.js';
+import { createSchedulingTools, CheckAvailabilityInput, FindMeetingTimesInput, } from './tools/scheduling.js';
 import { ListEmailsInput, SearchEmailsInput, GetEmailInput, GetUnreadCountInput, ListAttachmentsInput, DownloadAttachmentInput, ListCalendarsInput, ListEventsInput, GetEventInput, SearchEventsInput, CreateEventInput, RespondToEventInput, ListContactsInput, SearchContactsInput, GetContactInput, ListTasksInput, SearchTasksInput, GetTaskInput, ListNotesInput, GetNoteInput, SearchNotesInput, PrepareDeleteEmailInput, ConfirmDeleteEmailInput, PrepareMoveEmailInput, ConfirmMoveEmailInput, PrepareArchiveEmailInput, ConfirmArchiveEmailInput, PrepareJunkEmailInput, ConfirmJunkEmailInput, PrepareDeleteFolderInput, ConfirmDeleteFolderInput, PrepareEmptyFolderInput, ConfirmEmptyFolderInput, PrepareBatchDeleteEmailsInput, PrepareBatchMoveEmailsInput, ConfirmBatchOperationInput, MarkEmailReadInput, MarkEmailUnreadInput, SetEmailFlagInput, ClearEmailFlagInput, SetEmailCategoriesInput, CreateFolderInput, RenameFolderInput, MoveFolderInput, CreateDraftInput, UpdateDraftInput, ListDraftsInput, PrepareSendDraftInput, ConfirmSendDraftInput, PrepareSendEmailInput, ConfirmSendEmailInput, PrepareReplyEmailInput, ConfirmReplyEmailInput, PrepareForwardEmailInput, ConfirmForwardEmailInput, ReplyAsDraftInput, ForwardAsDraftInput, } from './tools/index.js';
 import { ApprovalTokenManager, hashEventForApproval, hashContactForApproval, hashTaskForApproval } from './approval/index.js';
 import { wrapError, OutlookNotRunningError, GraphError, } from './utils/errors.js';
@@ -1213,6 +1214,11 @@ const TOOLS = [
                     default: 'text',
                     description: 'Body content type (default: text)',
                 },
+                include_signature: {
+                    type: 'boolean',
+                    default: true,
+                    description: 'Include email signature (default: true)',
+                },
                 attachments: {
                     type: 'array',
                     description: 'File attachments',
@@ -1354,6 +1360,11 @@ const TOOLS = [
                     default: 'text',
                     description: 'Body content type (default: text)',
                 },
+                include_signature: {
+                    type: 'boolean',
+                    default: true,
+                    description: 'Include email signature (default: true)',
+                },
                 attachments: {
                     type: 'array',
                     description: 'File attachments',
@@ -1450,6 +1461,11 @@ const TOOLS = [
                 message_id: { type: 'number', description: 'The message ID to reply to' },
                 comment: { type: 'string', description: 'Initial reply body text' },
                 reply_all: { type: 'boolean', default: false, description: 'Reply to all recipients (default: false)' },
+                include_signature: {
+                    type: 'boolean',
+                    default: true,
+                    description: 'Include email signature (default: true)',
+                },
             },
             required: ['message_id'],
         },
@@ -1467,10 +1483,90 @@ const TOOLS = [
                     description: 'Forward recipients (can also add later via update_draft)',
                 },
                 comment: { type: 'string', description: 'Initial forward body text' },
+                include_signature: {
+                    type: 'boolean',
+                    default: true,
+                    description: 'Include email signature (default: true)',
+                },
             },
             required: ['message_id'],
         },
     },
+    // Signature management tools
+    {
+        name: 'set_signature',
+        description: 'Save an email signature that will be auto-appended to outgoing emails',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string', description: 'Signature content (HTML or plain text)' },
+                content_type: {
+                    type: 'string',
+                    enum: ['html', 'text'],
+                    default: 'html',
+                    description: 'Content type of the signature (default: html)',
+                },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'get_signature',
+        description: 'Get the currently stored email signature',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    // Calendar scheduling tools
+    {
+        name: 'check_availability',
+        description: 'Check free/busy availability for one or more people in a time window',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                email_addresses: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    description: 'Email addresses to check availability for',
+                },
+                start_time: { type: 'string', description: 'Start of time window (ISO 8601)' },
+                end_time: { type: 'string', description: 'End of time window (ISO 8601)' },
+                availability_view_interval: {
+                    type: 'number',
+                    default: 30,
+                    description: 'Time slot interval in minutes (default: 30)',
+                },
+            },
+            required: ['email_addresses', 'start_time', 'end_time'],
+        },
+    },
+    {
+        name: 'find_meeting_times',
+        description: 'Find available meeting time slots for a group of attendees',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                attendees: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    minItems: 1,
+                    description: 'Attendee email addresses',
+                },
+                duration_minutes: { type: 'number', description: 'Meeting duration in minutes' },
+                start_time: { type: 'string', description: 'Start of search window (ISO 8601, optional)' },
+                end_time: { type: 'string', description: 'End of search window (ISO 8601, optional)' },
+                max_candidates: {
+                    type: 'number',
+                    default: 5,
+                    description: 'Maximum number of time suggestions (default: 5)',
+                },
+            },
+            required: ['attendees', 'duration_minutes'],
+        },
+    },
 ];
 // =============================================================================
 // Server Creation
@@ -1501,6 +1597,7 @@ export function createServer() {
     let notesTools = null;
     let orgTools = null;
     let sendTools = null;
+    let schedulingTools = null;
     let calendarWriter = null;
     let calendarManager = null;
     let mailSender = null;
@@ -1543,6 +1640,7 @@ export function createServer() {
         const adapter = new GraphMailboxAdapter(graphRepository);
         orgTools = createMailboxOrganizationTools(adapter, tokenManager);
         sendTools = createMailSendTools(graphRepository, tokenManager);
+        schedulingTools = createSchedulingTools(graphRepository);
         initialized = true;
     });
     /**
@@ -1558,9 +1656,17 @@ export function createServer() {
             initializeAppleScriptBackend();
         }
     }
+    // Tools that only exist when using Graph API (signature + scheduling)
+    const GRAPH_ONLY_TOOL_NAMES = new Set([
+        'set_signature',
+        'get_signature',
+        'check_availability',
+        'find_meeting_times',
+    ]);
     // Register tool list handler
     server.setRequestHandler(ListToolsRequestSchema, () => {
-        return { tools: TOOLS };
+        const tools = useGraphApi ? TOOLS : TOOLS.filter((t) => !GRAPH_ONLY_TOOL_NAMES.has(t.name));
+        return { tools };
     });
     // Register tool call handler (async for Graph API support)
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
@@ -1569,7 +1675,7 @@ export function createServer() {
             await ensureInitialized();
             // Graph API mode - handle async operations directly
             if (useGraphApi && graphRepository != null) {
-                return await handleGraphToolCall(name, args, graphRepository, graphContentReaders, orgTools, sendTools, tokenManager);
+                return await handleGraphToolCall(name, args, graphRepository, graphContentReaders, orgTools, sendTools, schedulingTools, tokenManager);
             }
             // AppleScript mode - use sync tool interfaces
             return handleAppleScriptToolCall(name, args, accountRepository, mailTools, calendarTools, contactsTools, tasksTools, notesTools, orgTools, calendarWriter, calendarManager, mailSender);
@@ -1818,6 +1924,35 @@ async function handleSendToolCall(name, args, sendTools) {
             const result = await sendTools.forwardAsDraft(params);
             return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
         }
+        case 'set_signature': {
+            const params = SetSignatureInput.parse(args);
+            const result = sendTools.setSignature(params);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'get_signature': {
+            GetSignatureInput.parse(args ?? {});
+            const result = sendTools.getSignature();
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        default:
+            return null;
+    }
+}
+// =============================================================================
+// Scheduling Tool Handler (Graph API only)
+// =============================================================================
+async function handleSchedulingToolCall(name, args, schedulingTools) {
+    switch (name) {
+        case 'check_availability': {
+            const params = CheckAvailabilityInput.parse(args);
+            const result = await schedulingTools.checkAvailability(params);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        case 'find_meeting_times': {
+            const params = FindMeetingTimesInput.parse(args);
+            const result = await schedulingTools.findMeetingTimes(params);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
         default:
             return null;
     }
@@ -2322,7 +2457,7 @@ const ConfirmDeleteTaskInput = z.strictObject({
 // =============================================================================
 // Graph API Tool Handler
 // =============================================================================
-async function handleGraphToolCall(name, args, repository, contentReaders, orgTools, sendTools, tokenManager) {
+async function handleGraphToolCall(name, args, repository, contentReaders, orgTools, sendTools, schedulingTools, tokenManager) {
     // Handle mailbox organization tools (shared between backends)
     const orgResult = await handleOrgToolCall(name, args, orgTools);
     if (orgResult != null)
@@ -2331,6 +2466,10 @@ async function handleGraphToolCall(name, args, repository, contentReaders, orgTo
     const sendResult = await handleSendToolCall(name, args, sendTools);
     if (sendResult != null)
         return sendResult;
+    // Handle scheduling tools (Graph API only)
+    const schedulingResult = await handleSchedulingToolCall(name, args, schedulingTools);
+    if (schedulingResult != null)
+        return schedulingResult;
     try {
         switch (name) {
             // Mail tools