msoutlook-mcp 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared constants used across the codebase.
+ */
+/**
+ * Microsoft's own Outlook Web App client ID.
+ * This is the first-party app ID used by outlook.office.com itself.
+ * No app registration required — same pattern as msteams-mcp uses Teams' own client ID.
+ */
+export declare const OWA_CLIENT_ID = "9199bf20-a13f-4107-85dc-02114787ef48";
+/** OAuth token endpoint for work/school accounts (used as default when no tenant ID). */
+export declare const TOKEN_ENDPOINT = "https://login.microsoftonline.com/organizations/oauth2/v2.0/token";
+/** Primary resource scope for Outlook Web. */
+export declare const OWA_SCOPE = "https://outlook.office.com/.default";
+/** Microsoft Graph scope. */
+export declare const GRAPH_SCOPE = "https://graph.microsoft.com/.default";
+/** Outlook Web login URL. */
+export declare const OWA_URL = "https://outlook.office.com/mail/";
+export declare const OWA_BASE = "https://outlook.office.com";
+export declare const OWA_REST_V2 = "https://outlook.office.com/api/v2.0";
+export declare const GRAPH_BASE = "https://graph.microsoft.com/v1.0";
+/** Refresh tokens ~55 minutes before expiry (access tokens last 1 hour). */
+export declare const TOKEN_REFRESH_BUFFER_MS: number;
+/** How long to wait for user to complete browser login (ms). */
+export declare const LOGIN_TIMEOUT_MS: number;
+/** User-Agent presented to OWA APIs so requests look like the web client. */
+export declare const OWA_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36 Edg/136.0.0.0";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;;GAIG;AACH,eAAO,MAAM,aAAa,yCAAyC,CAAC;AAEpE,yFAAyF;AACzF,eAAO,MAAM,cAAc,sEAAsE,CAAC;AAElG,8CAA8C;AAC9C,eAAO,MAAM,SAAS,wCAAwC,CAAC;AAE/D,6BAA6B;AAC7B,eAAO,MAAM,WAAW,yCAAyC,CAAC;AAElE,6BAA6B;AAC7B,eAAO,MAAM,OAAO,qCAAqC,CAAC;AAM1D,eAAO,MAAM,QAAQ,+BAA+B,CAAC;AACrD,eAAO,MAAM,WAAW,wCAAyB,CAAC;AAClD,eAAO,MAAM,UAAU,qCAAqC,CAAC;AAM7D,4EAA4E;AAC5E,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AAEtD,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAM9C,6EAA6E;AAC7E,eAAO,MAAM,cAAc,wIAC4G,CAAC"}

package/dist/constants.js

@@ -0,0 +1,39 @@
+/**
+ * Shared constants used across the codebase.
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// OAuth / Auth
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Microsoft's own Outlook Web App client ID.
+ * This is the first-party app ID used by outlook.office.com itself.
+ * No app registration required — same pattern as msteams-mcp uses Teams' own client ID.
+ */
+export const OWA_CLIENT_ID = '9199bf20-a13f-4107-85dc-02114787ef48';
+/** OAuth token endpoint for work/school accounts (used as default when no tenant ID). */
+export const TOKEN_ENDPOINT = 'https://login.microsoftonline.com/organizations/oauth2/v2.0/token';
+/** Primary resource scope for Outlook Web. */
+export const OWA_SCOPE = 'https://outlook.office.com/.default';
+/** Microsoft Graph scope. */
+export const GRAPH_SCOPE = 'https://graph.microsoft.com/.default';
+/** Outlook Web login URL. */
+export const OWA_URL = 'https://outlook.office.com/mail/';
+// ─────────────────────────────────────────────────────────────────────────────
+// API Base URLs
+// ─────────────────────────────────────────────────────────────────────────────
+export const OWA_BASE = 'https://outlook.office.com';
+export const OWA_REST_V2 = `${OWA_BASE}/api/v2.0`;
+export const GRAPH_BASE = 'https://graph.microsoft.com/v1.0';
+// ─────────────────────────────────────────────────────────────────────────────
+// Token / Refresh
+// ─────────────────────────────────────────────────────────────────────────────
+/** Refresh tokens ~55 minutes before expiry (access tokens last 1 hour). */
+export const TOKEN_REFRESH_BUFFER_MS = 55 * 60 * 1000;
+/** How long to wait for user to complete browser login (ms). */
+export const LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
+// ─────────────────────────────────────────────────────────────────────────────
+// HTTP
+// ─────────────────────────────────────────────────────────────────────────────
+/** User-Agent presented to OWA APIs so requests look like the web client. */
+export const OWA_USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/136.0.0.0 Safari/537.36 Edg/136.0.0.0';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,sCAAsC,CAAC;AAEpE,yFAAyF;AACzF,MAAM,CAAC,MAAM,cAAc,GAAG,mEAAmE,CAAC;AAElG,8CAA8C;AAC9C,MAAM,CAAC,MAAM,SAAS,GAAG,qCAAqC,CAAC;AAE/D,6BAA6B;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAElE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,OAAO,GAAG,kCAAkC,CAAC;AAE1D,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,QAAQ,GAAG,4BAA4B,CAAC;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,QAAQ,WAAW,CAAC;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,kCAAkC,CAAC;AAE7D,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,4EAA4E;AAC5E,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEtD,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GACzB,qIAAqI,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * msoutlook-mcp — MCP server for Microsoft Outlook Web
+ *
+ * No app registration required. Uses your existing Outlook Web session,
+ * the same way msteams-mcp uses the Microsoft Teams web session.
+ *
+ * Usage: npx msoutlook-mcp
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG"}

package/dist/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+/**
+ * msoutlook-mcp — MCP server for Microsoft Outlook Web
+ *
+ * No app registration required. Uses your existing Outlook Web session,
+ * the same way msteams-mcp uses the Microsoft Teams web session.
+ *
+ * Usage: npx msoutlook-mcp
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+import { logger } from './utils/logger.js';
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.server.connect(transport);
+    logger.info('msoutlook-mcp running on stdio');
+}
+main().catch(err => {
+    logger.error('Fatal error', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACjB,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP server setup — registers all tools and starts the server.
+ */
+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;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,YAAY,IAAI,SAAS,CAYxC"}

package/dist/server.js

@@ -0,0 +1,20 @@
+/**
+ * MCP server setup — registers all tools and starts the server.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerAuthTools } from './tools/auth-tools.js';
+import { registerMailTools } from './tools/mail-tools.js';
+import { registerCalendarTools } from './tools/calendar-tools.js';
+import { registerContactTools } from './tools/contact-tools.js';
+export function createServer() {
+    const server = new McpServer({
+        name: 'msoutlook-mcp',
+        version: '0.1.0',
+    });
+    registerAuthTools(server);
+    registerMailTools(server);
+    registerCalendarTools(server);
+    registerContactTools(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;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/auth-tools.d.ts

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

package/dist/tools/auth-tools.d.ts.map

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

package/dist/tools/auth-tools.js

@@ -0,0 +1,116 @@
+/**
+ * Authentication MCP tools.
+ */
+import { z } from 'zod';
+import { browserLogin, getAuthStatus, clearSession, getOwaToken, hasSessionState, isSessionLikelyExpired } from '../auth/index.js';
+/** Minimum minutes remaining before we consider the token "still valid" (skip re-login). */
+const TOKEN_VALID_THRESHOLD_MINUTES = 10;
+export function registerAuthTools(server) {
+    // ── outlook_login ────────────────────────────────────────────────────────
+    server.tool('outlook_login', 'Sign in to Outlook Web. Tries silently first (no browser); opens a browser only when the session has expired. Set force_new: true to force a full re-login.', {
+        force_new: z.boolean().optional().describe('Force a full re-login even if a session exists — clears the saved session first. Default: false.'),
+    }, async ({ force_new }) => {
+        const forceNew = force_new ?? false;
+        // Fast path: valid token and not forcing re-login
+        if (!forceNew) {
+            const existingToken = await getOwaToken();
+            if (existingToken) {
+                const status = getAuthStatus();
+                const mins = status.owaTokenMinutesRemaining ?? 0;
+                if (mins >= TOKEN_VALID_THRESHOLD_MINUTES) {
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    success: true,
+                                    message: `Already authenticated. Token valid for ${mins} more minutes.`,
+                                    upn: status.upn,
+                                    tokenStatus: {
+                                        expiresAt: status.owaTokenExpiry,
+                                        minutesRemaining: mins,
+                                    },
+                                }, null, 2),
+                            }],
+                    };
+                }
+            }
+        }
+        // Need to open a browser — warn the user not to close it
+        if (!forceNew) {
+            process.stderr.write('[msoutlook-mcp] Opening browser. Do NOT close the window — it closes automatically once signed in.\n');
+        }
+        const result = await browserLogin(forceNew);
+        if (!result) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            message: 'Login failed. If you closed the browser window manually, run outlook_login again and wait for it to close on its own.',
+                        }, null, 2),
+                    }],
+            };
+        }
+        // Return path-specific message (mirrors msteams-mcp)
+        const messages = {
+            'token-cache': 'Already authenticated. Token valid.',
+            'headless-sso': 'Login completed silently via SSO. Session has been saved.',
+            'headed-browser': 'Login completed successfully. Session has been saved.',
+        };
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        message: messages[result.method],
+                        upn: result.upn,
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── outlook_status ───────────────────────────────────────────────────────
+    server.tool('outlook_status', 'Check the current authentication status and token validity.', {}, async () => {
+        const token = await getOwaToken();
+        if (!token) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ authenticated: false, message: 'Not authenticated. Run outlook_login to sign in.' }, null, 2),
+                    }],
+            };
+        }
+        const status = getAuthStatus();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        authenticated: true,
+                        upn: status.upn,
+                        tenantId: status.tenantId,
+                        owaToken: {
+                            expiresAt: status.owaTokenExpiry,
+                            minutesRemaining: status.owaTokenMinutesRemaining,
+                        },
+                        graphToken: status.graphTokenExpiry ? {
+                            expiresAt: status.graphTokenExpiry,
+                        } : null,
+                        session: {
+                            exists: hasSessionState(),
+                            likelyExpired: isSessionLikelyExpired(),
+                        },
+                    }, null, 2),
+                }],
+        };
+    });
+    // ── outlook_logout ───────────────────────────────────────────────────────
+    server.tool('outlook_logout', 'Clear the saved Outlook session and tokens. You will need to run outlook_login again.', {}, async () => {
+        clearSession();
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ success: true, message: 'Session cleared. Run outlook_login to sign in again.' }, null, 2),
+                }],
+        };
+    });
+}
+//# sourceMappingURL=auth-tools.js.map

package/dist/tools/auth-tools.js.map

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

package/dist/tools/calendar-tools.d.ts

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

package/dist/tools/calendar-tools.d.ts.map

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

package/dist/tools/calendar-tools.js

@@ -0,0 +1,168 @@
+/**
+ * Calendar MCP tools.
+ */
+import { z } from 'zod';
+import { listEvents, getEvent, createEvent, updateEvent, deleteEvent, respondToEvent, searchEvents, listCalendars, } from '../api/calendar.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Formatters
+// ─────────────────────────────────────────────────────────────────────────────
+function formatEvent(e, full = false) {
+    const start = e.Start?.DateTime ?? 'Unknown';
+    const end = e.End?.DateTime ?? 'Unknown';
+    const tz = e.Start?.TimeZone ?? '';
+    const location = e.Location?.DisplayName ?? '';
+    const organizer = e.Organizer?.EmailAddress?.Address ?? '';
+    const attendeeCount = e.Attendees?.length ?? 0;
+    const lines = [
+        `ID: ${e.Id}`,
+        `Subject: ${e.Subject}`,
+        `Start: ${start} ${tz}`,
+        `End: ${end}`,
+        location ? `Location: ${location}` : '',
+        organizer ? `Organizer: ${organizer}` : '',
+        attendeeCount > 0 ? `Attendees: ${attendeeCount}` : '',
+        e.IsOnlineMeeting ? `Online Meeting: ${e.OnlineMeetingUrl ?? 'Yes'}` : '',
+        e.ResponseStatus ? `My Response: ${e.ResponseStatus.Response}` : '',
+        e.WebLink ? `Web URL: ${e.WebLink}` : '',
+    ].filter(Boolean);
+    if (full) {
+        if (e.Attendees?.length) {
+            lines.push('', 'Attendees:');
+            lines.push(...e.Attendees.map(a => `  - ${a.EmailAddress.Name ?? a.EmailAddress.Address} (${a.Type ?? 'Required'}) — ${a.Status?.Response ?? 'None'}`));
+        }
+        if (e.Body) {
+            lines.push('', `Body (${e.Body.ContentType}):`, e.Body.Content.slice(0, 3000));
+        }
+    }
+    else if (e.BodyPreview) {
+        lines.push(`Preview: ${e.BodyPreview.slice(0, 200)}`);
+    }
+    return lines.join('\n');
+}
+function formatEventList(events) {
+    if (events.length === 0)
+        return 'No events found.';
+    return events.map((e, i) => `--- Event ${i + 1} ---\n${formatEvent(e)}`).join('\n\n');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Tools
+// ─────────────────────────────────────────────────────────────────────────────
+export function registerCalendarTools(server) {
+    // ── outlook_list_events ──────────────────────────────────────────────────
+    server.tool('outlook_list_events', 'List calendar events within a date range.', {
+        start_date: z.string().optional().describe('ISO 8601 start datetime (defaults to now)'),
+        end_date: z.string().optional().describe('ISO 8601 end datetime (defaults to 7 days from now)'),
+        top: z.number().int().min(1).max(100).optional().describe('Max events to return (default 50)'),
+        calendar_id: z.string().optional().describe('Specific calendar ID (defaults to primary calendar)'),
+    }, async ({ start_date, end_date, top, calendar_id }) => {
+        const events = await listEvents({
+            startDateTime: start_date,
+            endDateTime: end_date,
+            top: top ?? 50,
+            calendarId: calendar_id,
+        });
+        return { content: [{ type: 'text', text: formatEventList(events) }] };
+    });
+    // ── outlook_get_event ────────────────────────────────────────────────────
+    server.tool('outlook_get_event', 'Get full details of a calendar event including attendees and body.', {
+        id: z.string().describe('Event ID'),
+    }, async ({ id }) => {
+        const event = await getEvent(id);
+        return { content: [{ type: 'text', text: formatEvent(event, true) }] };
+    });
+    // ── outlook_create_event ─────────────────────────────────────────────────
+    server.tool('outlook_create_event', 'Create a new calendar event or meeting.', {
+        subject: z.string().describe('Event title/subject'),
+        start: z.string().describe('Start datetime in ISO 8601 format (e.g. 2026-06-10T14:00:00)'),
+        end: z.string().describe('End datetime in ISO 8601 format'),
+        time_zone: z.string().optional().describe('Timezone name (e.g. Europe/London, UTC). Defaults to UTC'),
+        location: z.string().optional().describe('Location or meeting room'),
+        body: z.string().optional().describe('Event description/body'),
+        attendees: z.array(z.object({
+            email: z.string().email(),
+            name: z.string().optional(),
+            type: z.enum(['Required', 'Optional']).optional(),
+        })).optional().describe('List of attendees'),
+        is_online_meeting: z.boolean().optional().describe('Add a Teams/online meeting link (default: false)'),
+        is_all_day: z.boolean().optional().describe('All-day event (default: false)'),
+        importance: z.enum(['Low', 'Normal', 'High']).optional(),
+    }, async (params) => {
+        const event = await createEvent({
+            subject: params.subject,
+            start: params.start,
+            end: params.end,
+            timeZone: params.time_zone,
+            location: params.location,
+            body: params.body,
+            attendees: params.attendees,
+            isOnlineMeeting: params.is_online_meeting,
+            isAllDay: params.is_all_day,
+            importance: params.importance,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Event created.\nID: ${event.Id}\nSubject: ${event.Subject}\nStart: ${event.Start.DateTime}`,
+                }],
+        };
+    });
+    // ── outlook_update_event ─────────────────────────────────────────────────
+    server.tool('outlook_update_event', 'Update an existing calendar event.', {
+        id: z.string().describe('Event ID to update'),
+        subject: z.string().optional().describe('New subject'),
+        start: z.string().optional().describe('New start datetime (ISO 8601)'),
+        end: z.string().optional().describe('New end datetime (ISO 8601)'),
+        time_zone: z.string().optional(),
+        location: z.string().optional(),
+        body: z.string().optional(),
+    }, async ({ id, ...updates }) => {
+        const event = await updateEvent(id, {
+            subject: updates.subject,
+            start: updates.start,
+            end: updates.end,
+            timeZone: updates.time_zone,
+            location: updates.location,
+            body: updates.body,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Event updated.\nID: ${event.Id}\nSubject: ${event.Subject}`,
+                }],
+        };
+    });
+    // ── outlook_delete_event ─────────────────────────────────────────────────
+    server.tool('outlook_delete_event', 'Delete a calendar event.', {
+        id: z.string().describe('Event ID to delete'),
+    }, async ({ id }) => {
+        await deleteEvent(id);
+        return { content: [{ type: 'text', text: 'Event deleted.' }] };
+    });
+    // ── outlook_respond_to_event ─────────────────────────────────────────────
+    server.tool('outlook_respond_to_event', 'Accept, decline, or tentatively accept a meeting invitation.', {
+        id: z.string().describe('Event ID'),
+        response: z.enum(['accept', 'decline', 'tentativelyAccept']).describe('Your response'),
+        comment: z.string().optional().describe('Optional response message'),
+    }, async ({ id, response, comment }) => {
+        await respondToEvent(id, response, comment);
+        return { content: [{ type: 'text', text: `Meeting response sent: ${response}.` }] };
+    });
+    // ── outlook_search_events ────────────────────────────────────────────────
+    server.tool('outlook_search_events', 'Search calendar events by keyword.', {
+        query: z.string().describe('Search keyword'),
+        from_date: z.string().optional().describe('Search from this date (ISO 8601)'),
+        to_date: z.string().optional().describe('Search until this date (ISO 8601)'),
+    }, async ({ query, from_date, to_date }) => {
+        const events = await searchEvents(query, from_date, to_date);
+        return { content: [{ type: 'text', text: formatEventList(events) }] };
+    });
+    // ── outlook_list_calendars ───────────────────────────────────────────────
+    server.tool('outlook_list_calendars', 'List all calendars in the account.', {}, async () => {
+        const calendars = await listCalendars();
+        const text = calendars
+            .map(c => `${c.Name} (ID: ${c.Id})${c.IsDefaultCalendar ? ' [Default]' : ''}${c.CanEdit ? ' [Editable]' : ''}`)
+            .join('\n');
+        return { content: [{ type: 'text', text: text || 'No calendars found.' }] };
+    });
+}
+//# sourceMappingURL=calendar-tools.js.map

package/dist/tools/calendar-tools.js.map

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

package/dist/tools/contact-tools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Contacts and people MCP tools.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerContactTools(server: McpServer): void;
+//# sourceMappingURL=contact-tools.d.ts.map

package/dist/tools/contact-tools.d.ts.map

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

package/dist/tools/contact-tools.js

@@ -0,0 +1,105 @@
+/**
+ * Contacts and people MCP tools.
+ */
+import { z } from 'zod';
+import { listContacts, getContact, createContact, deleteContact } from '../api/contacts.js';
+import { searchPeople } from '../api/people.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Formatters
+// ─────────────────────────────────────────────────────────────────────────────
+function formatContact(c) {
+    const emails = c.EmailAddresses?.map(e => e.Address).join(', ') ?? '';
+    const phones = [...(c.BusinessPhones ?? []), c.MobilePhone].filter(Boolean).join(', ');
+    return [
+        `ID: ${c.Id}`,
+        `Name: ${c.DisplayName}`,
+        emails ? `Email: ${emails}` : '',
+        phones ? `Phone: ${phones}` : '',
+        c.JobTitle ? `Title: ${c.JobTitle}` : '',
+        c.CompanyName ? `Company: ${c.CompanyName}` : '',
+        c.Department ? `Department: ${c.Department}` : '',
+    ].filter(Boolean).join('\n');
+}
+function formatPerson(p) {
+    const email = p.ScoredEmailAddresses?.[0]?.Address
+        ?? p.EmailAddresses?.[0]?.Address
+        ?? '';
+    return [
+        `Name: ${p.DisplayName}`,
+        email ? `Email: ${email}` : '',
+        p.UserPrincipalName ? `UPN: ${p.UserPrincipalName}` : '',
+        p.JobTitle ? `Title: ${p.JobTitle}` : '',
+        p.Department ? `Department: ${p.Department}` : '',
+        p.CompanyName ? `Company: ${p.CompanyName}` : '',
+    ].filter(Boolean).join('\n');
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Tools
+// ─────────────────────────────────────────────────────────────────────────────
+export function registerContactTools(server) {
+    // ── outlook_list_contacts ────────────────────────────────────────────────
+    server.tool('outlook_list_contacts', 'List contacts from the Outlook address book.', {
+        search: z.string().optional().describe('Search by name or email'),
+        top: z.number().int().min(1).max(100).optional().describe('Max results (default 25)'),
+    }, async ({ search, top }) => {
+        const contacts = await listContacts(search, top ?? 25);
+        if (contacts.length === 0)
+            return { content: [{ type: 'text', text: 'No contacts found.' }] };
+        const text = contacts.map((c, i) => `--- Contact ${i + 1} ---\n${formatContact(c)}`).join('\n\n');
+        return { content: [{ type: 'text', text }] };
+    });
+    // ── outlook_get_contact ──────────────────────────────────────────────────
+    server.tool('outlook_get_contact', 'Get full details of a contact by ID.', {
+        id: z.string().describe('Contact ID'),
+    }, async ({ id }) => {
+        const contact = await getContact(id);
+        return { content: [{ type: 'text', text: formatContact(contact) }] };
+    });
+    // ── outlook_create_contact ───────────────────────────────────────────────
+    server.tool('outlook_create_contact', 'Create a new contact in Outlook.', {
+        given_name: z.string().optional().describe('First name'),
+        surname: z.string().optional().describe('Last name'),
+        email: z.string().email().optional().describe('Email address'),
+        business_phone: z.string().optional().describe('Business phone number'),
+        mobile_phone: z.string().optional().describe('Mobile phone number'),
+        job_title: z.string().optional().describe('Job title'),
+        company_name: z.string().optional().describe('Company or organisation name'),
+        notes: z.string().optional().describe('Personal notes'),
+    }, async (params) => {
+        const contact = await createContact({
+            givenName: params.given_name,
+            surname: params.surname,
+            email: params.email,
+            businessPhone: params.business_phone,
+            mobilePhone: params.mobile_phone,
+            jobTitle: params.job_title,
+            companyName: params.company_name,
+            notes: params.notes,
+        });
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Contact created.\nID: ${contact.Id}\nName: ${contact.DisplayName}`,
+                }],
+        };
+    });
+    // ── outlook_delete_contact ───────────────────────────────────────────────
+    server.tool('outlook_delete_contact', 'Delete a contact by ID.', {
+        id: z.string().describe('Contact ID to delete'),
+    }, async ({ id }) => {
+        await deleteContact(id);
+        return { content: [{ type: 'text', text: 'Contact deleted.' }] };
+    });
+    // ── outlook_search_people ────────────────────────────────────────────────
+    server.tool('outlook_search_people', 'Search the organisation directory for people by name or email.', {
+        query: z.string().describe('Name, email, or job title to search for'),
+        top: z.number().int().min(1).max(25).optional().describe('Max results (default 10)'),
+    }, async ({ query, top }) => {
+        const people = await searchPeople(query, top ?? 10);
+        if (people.length === 0)
+            return { content: [{ type: 'text', text: 'No people found.' }] };
+        const text = people.map((p, i) => `--- Person ${i + 1} ---\n${formatPerson(p)}`).join('\n\n');
+        return { content: [{ type: 'text', text }] };
+    });
+}
+//# sourceMappingURL=contact-tools.js.map

package/dist/tools/contact-tools.js.map

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