msoutlook-mcp 0.1.0

package/README.md

@@ -0,0 +1,134 @@
+# msoutlook-mcp
+
+MCP server for Microsoft Outlook Web — no app registration required.
+
+Uses your existing Outlook Web session (the same way [msteams-mcp](https://github.com/m0nkmaster/msteams-mcp) uses the Teams web session). Opens a browser once for login, then caches tokens and refreshes them automatically.
+
+## How it works
+
+Microsoft Outlook Web (OWA) uses MSAL to store OAuth tokens in `localStorage`. This server:
+
+1. Opens a browser to `outlook.office.com` via Playwright
+2. Extracts the MSAL token cache from `localStorage` — using OWA's own first-party client ID (`9199bf20-a13f-4107-85dc-02114787ef48`)
+3. Caches the access token, refresh token, and session state in `~/.msoutlook-mcp-server/` (AES-256-GCM encrypted)
+4. Refreshes tokens automatically using the refresh token (HTTP, no browser) or headless browser as fallback
+
+No Azure app registration. No admin consent. No client secrets. Your access is limited to what your account can already do.
+
+## Quick start
+
+```json
+{
+  "mcpServers": {
+    "outlook": {
+      "command": "npx",
+      "args": ["-y", "msoutlook-mcp@latest"]
+    }
+  }
+}
+```
+
+Then run `outlook_login` from your MCP client to open the browser and authenticate.
+
+## Tools
+
+### Auth
+
+| Tool | Description |
+|------|-------------|
+| `outlook_login` | Open browser to sign in to Outlook Web |
+| `outlook_status` | Check authentication status and token validity |
+| `outlook_logout` | Clear saved session and tokens |
+
+### Email
+
+| Tool | Description |
+|------|-------------|
+| `outlook_list_emails` | List emails from any folder (Inbox by default) |
+| `outlook_get_email` | Read full email content by ID |
+| `outlook_get_unread` | Get unread emails from Inbox |
+| `outlook_search_emails` | Search emails by keyword |
+| `outlook_send_email` | Send an email |
+| `outlook_create_draft` | Create a draft without sending |
+| `outlook_send_draft` | Send a previously created draft |
+| `outlook_reply` | Reply to an email (or reply all) |
+| `outlook_forward` | Forward an email |
+| `outlook_mark_read` | Mark email as read or unread |
+| `outlook_flag` | Flag or unflag an email |
+| `outlook_move_email` | Move email to a different folder |
+| `outlook_delete_email` | Delete an email |
+| `outlook_list_folders` | List all mail folders with unread counts |
+
+### Calendar
+
+| Tool | Description |
+|------|-------------|
+| `outlook_list_events` | List calendar events in a date range |
+| `outlook_get_event` | Get full event details including attendees |
+| `outlook_create_event` | Create a meeting or appointment |
+| `outlook_update_event` | Update an existing event |
+| `outlook_delete_event` | Delete an event |
+| `outlook_respond_to_event` | Accept, decline, or tentatively accept an invite |
+| `outlook_search_events` | Search events by keyword |
+| `outlook_list_calendars` | List all calendars |
+
+### Contacts & People
+
+| Tool | Description |
+|------|-------------|
+| `outlook_list_contacts` | List/search contacts |
+| `outlook_get_contact` | Get contact details by ID |
+| `outlook_create_contact` | Create a new contact |
+| `outlook_delete_contact` | Delete a contact |
+| `outlook_search_people` | Search the organisation directory |
+
+## Session storage
+
+Session files are stored encrypted in `~/.msoutlook-mcp-server/`:
+
+- `session-state.json` — Playwright browser session (cookies + localStorage)
+- `token-cache.json` — Extracted and cached tokens
+- `browser-profile/` — Persistent browser profile for headless refresh
+
+If your session expires, run `outlook_login` again.
+
+## Token refresh
+
+Tokens are refreshed automatically:
+
+1. **HTTP refresh** (fast, no browser) — uses the cached refresh token with OWA's client ID
+2. **Headless browser refresh** — fallback if HTTP refresh fails; opens a headless Edge window to silently re-acquire tokens from the saved browser session
+
+## Requirements
+
+- Node.js 20+
+- A Chromium-based browser: Edge or Chrome (auto-detected from system default)
+- A Microsoft 365 work/school account or personal Microsoft account
+
+## Platform support
+
+| Feature | macOS | Linux | Windows |
+|---------|-------|-------|---------|
+| Browser auto-detection | System default (Edge/Chrome) | Chrome fallback | Edge (pre-installed) |
+| SSO cookie import | ✅ Chrome + Edge via Keychain | ✅ Chrome + Edge via libsecret / `"peanuts"` fallback | ✅ Edge via DPAPI (PowerShell) |
+| Windows Chrome 127+ cookies | — | — | ⚠️ App-Bound Encryption — not supported. Use Edge instead. |
+| Headed browser fallback | ✅ | ✅ | ✅ |
+
+Cookie import is a best-effort optimisation. If it cannot run (e.g. no matching browser installed, Keychain denied), the MCP falls back to opening a headed browser where you sign in once manually — the session then persists.
+
+## Security notes
+
+- Uses the same auth as the Outlook web client — your access is limited to what your account can do
+- Tokens are encrypted at rest (AES-256-GCM with a machine-derived key)
+- Uses undocumented internal APIs — Microsoft may change these without notice
+- Always confirm email content with the user before sending
+
+## Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `MSOUTLOOK_DEBUG=true` | Enable debug logging to stderr |
+| `MSOUTLOOK_BROWSER=chrome` | Force a specific browser: `chrome` or `msedge`. If unset, uses the macOS system default browser; falls back to Chrome on macOS/Linux and Edge on Windows. |
+| `MSOUTLOOK_CHROME_PROFILE` | Pin a specific Chrome profile dir for cookie import (e.g. `Profile 1`). Defaults to `Default`. |
+| `MSOUTLOOK_EDGE_PROFILE` | Pin a specific Edge profile dir for cookie import (e.g. `Profile 1`). Defaults to `Default`. |
+| `MSOUTLOOK_SKIP_COOKIE_IMPORT=true` | Skip importing SSO cookies from your real browser (avoids the one-time Keychain/keyring prompt). You'll sign in once manually in the browser; the persistent profile then remembers the session. |

package/dist/api/calendar.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Calendar API — events, meetings, and availability.
+ */
+import type { Recipient } from './mail.js';
+export interface DateTimeTimeZone {
+    DateTime: string;
+    TimeZone: string;
+}
+export interface Attendee {
+    EmailAddress: {
+        Name?: string;
+        Address: string;
+    };
+    Type?: 'Required' | 'Optional' | 'Resource';
+    Status?: {
+        Response: string;
+        Time: string;
+    };
+}
+export interface CalendarEvent {
+    Id: string;
+    Subject: string;
+    BodyPreview?: string;
+    Body?: {
+        ContentType: string;
+        Content: string;
+    };
+    Start: DateTimeTimeZone;
+    End: DateTimeTimeZone;
+    Location?: {
+        DisplayName: string;
+    };
+    Organizer?: Recipient;
+    Attendees?: Attendee[];
+    IsAllDay?: boolean;
+    IsCancelled?: boolean;
+    IsOnlineMeeting?: boolean;
+    OnlineMeetingUrl?: string;
+    Recurrence?: unknown;
+    Importance?: string;
+    Sensitivity?: string;
+    ShowAs?: string;
+    WebLink?: string;
+    ResponseStatus?: {
+        Response: string;
+        Time: string;
+    };
+}
+export interface Calendar {
+    Id: string;
+    Name: string;
+    Color?: string;
+    IsDefaultCalendar?: boolean;
+    CanEdit?: boolean;
+}
+export interface ListEventsOptions {
+    calendarId?: string;
+    startDateTime?: string;
+    endDateTime?: string;
+    top?: number;
+    filter?: string;
+    select?: string[];
+}
+export declare function listEvents(opts?: ListEventsOptions): Promise<CalendarEvent[]>;
+export declare function getEvent(id: string): Promise<CalendarEvent>;
+export interface CreateEventOptions {
+    subject: string;
+    body?: string;
+    bodyType?: 'Text' | 'HTML';
+    start: string;
+    end: string;
+    timeZone?: string;
+    location?: string;
+    attendees?: Array<{
+        email: string;
+        name?: string;
+        type?: 'Required' | 'Optional';
+    }>;
+    isOnlineMeeting?: boolean;
+    importance?: 'Low' | 'Normal' | 'High';
+    isAllDay?: boolean;
+}
+export declare function createEvent(opts: CreateEventOptions): Promise<CalendarEvent>;
+export declare function updateEvent(id: string, updates: Partial<CreateEventOptions>): Promise<CalendarEvent>;
+export declare function deleteEvent(id: string): Promise<void>;
+export type EventResponse = 'accept' | 'decline' | 'tentativelyAccept';
+export declare function respondToEvent(id: string, response: EventResponse, comment?: string): Promise<void>;
+export declare function searchEvents(query: string, fromDate?: string, toDate?: string): Promise<CalendarEvent[]>;
+export declare function listCalendars(): Promise<Calendar[]>;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/api/calendar.d.ts.map

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

package/dist/api/calendar.js

@@ -0,0 +1,102 @@
+/**
+ * Calendar API — events, meetings, and availability.
+ */
+import { owaGet, owaPost, owaPatch, owaDelete } from './client.js';
+export async function listEvents(opts = {}) {
+    const path = opts.calendarId ? `/calendars/${opts.calendarId}/calendarview` : '/calendarview';
+    const now = new Date();
+    const weekOut = new Date(now.getTime() + 7 * 24 * 60 * 60 * 1000);
+    const params = {
+        startDateTime: opts.startDateTime ?? now.toISOString(),
+        endDateTime: opts.endDateTime ?? weekOut.toISOString(),
+        '$top': String(opts.top ?? 50),
+        '$orderby': 'start/dateTime asc',
+        '$select': (opts.select ?? [
+            'Id', 'Subject', 'BodyPreview', 'Start', 'End', 'Location',
+            'Organizer', 'Attendees', 'IsAllDay', 'IsCancelled', 'IsOnlineMeeting',
+            'OnlineMeetingUrl', 'ResponseStatus', 'WebLink',
+        ]).join(','),
+    };
+    if (opts.filter)
+        params['$filter'] = opts.filter;
+    const res = await owaGet(path, params);
+    return res.value;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Get event
+// ─────────────────────────────────────────────────────────────────────────────
+export async function getEvent(id) {
+    return owaGet(`/events/${id}`);
+}
+export async function createEvent(opts) {
+    const tz = opts.timeZone ?? 'UTC';
+    const attendees = opts.attendees?.map(a => ({
+        EmailAddress: { Address: a.email, Name: a.name ?? a.email },
+        Type: a.type ?? 'Required',
+    }));
+    return owaPost('/events', {
+        Subject: opts.subject,
+        Body: { ContentType: opts.bodyType ?? 'Text', Content: opts.body ?? '' },
+        Start: { DateTime: opts.start, TimeZone: tz },
+        End: { DateTime: opts.end, TimeZone: tz },
+        ...(opts.location ? { Location: { DisplayName: opts.location } } : {}),
+        ...(attendees?.length ? { Attendees: attendees } : {}),
+        IsOnlineMeeting: opts.isOnlineMeeting ?? false,
+        Importance: opts.importance ?? 'Normal',
+        IsAllDay: opts.isAllDay ?? false,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Update event
+// ─────────────────────────────────────────────────────────────────────────────
+export async function updateEvent(id, updates) {
+    const tz = updates.timeZone ?? 'UTC';
+    const body = {};
+    if (updates.subject !== undefined)
+        body.Subject = updates.subject;
+    if (updates.body !== undefined) {
+        body.Body = { ContentType: updates.bodyType ?? 'Text', Content: updates.body };
+    }
+    if (updates.start !== undefined)
+        body.Start = { DateTime: updates.start, TimeZone: tz };
+    if (updates.end !== undefined)
+        body.End = { DateTime: updates.end, TimeZone: tz };
+    if (updates.location !== undefined)
+        body.Location = { DisplayName: updates.location };
+    if (updates.isOnlineMeeting !== undefined)
+        body.IsOnlineMeeting = updates.isOnlineMeeting;
+    return owaPatch(`/events/${id}`, body);
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Delete event
+// ─────────────────────────────────────────────────────────────────────────────
+export async function deleteEvent(id) {
+    await owaDelete(`/events/${id}`);
+}
+export async function respondToEvent(id, response, comment) {
+    await owaPost(`/events/${id}/${response}`, {
+        Comment: comment ?? '',
+        SendResponse: true,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Search events
+// ─────────────────────────────────────────────────────────────────────────────
+export async function searchEvents(query, fromDate, toDate) {
+    return listEvents({
+        startDateTime: fromDate,
+        endDateTime: toDate,
+        filter: `contains(subject,'${query.replace(/'/g, "''")}')`,
+        top: 25,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Calendars
+// ─────────────────────────────────────────────────────────────────────────────
+export async function listCalendars() {
+    const res = await owaGet('/calendars', {
+        '$select': 'Id,Name,Color,IsDefaultCalendar,CanEdit',
+    });
+    return res.value;
+}
+//# sourceMappingURL=calendar.js.map

package/dist/api/calendar.js.map

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

package/dist/api/client.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Base API client for Outlook Web API calls.
+ *
+ * Uses the OWA REST API v2 (https://outlook.office.com/api/v2.0/me/...)
+ * which is the same API the Outlook mobile and web clients use internally.
+ * The token from the OWA session grants access to all required scopes.
+ */
+export declare function owaGet<T>(path: string, params?: Record<string, string>): Promise<T>;
+export declare function owaPost<T>(path: string, body: unknown): Promise<T>;
+export declare function owaPatch<T>(path: string, body: unknown): Promise<T>;
+export declare function owaDelete(path: string): Promise<void>;
+export declare function graphGet<T>(path: string, params?: Record<string, string>): Promise<T>;
+export declare function graphPost<T>(path: string, body: unknown): Promise<T>;
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,wBAAsB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAezF;AAED,wBAAsB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAUxE;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAUzE;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3D;AAMD,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAe3F;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAU1E"}

package/dist/api/client.js

@@ -0,0 +1,93 @@
+/**
+ * Base API client for Outlook Web API calls.
+ *
+ * Uses the OWA REST API v2 (https://outlook.office.com/api/v2.0/me/...)
+ * which is the same API the Outlook mobile and web clients use internally.
+ * The token from the OWA session grants access to all required scopes.
+ */
+import { getOwaToken, getGraphToken } from '../auth/index.js';
+import { OWA_REST_V2, GRAPH_BASE, OWA_BASE } from '../constants.js';
+import { getBearerHeaders, parseResponse, fetchWithRetry } from '../utils/http.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// OWA REST API client
+// ─────────────────────────────────────────────────────────────────────────────
+export async function owaGet(path, params) {
+    const token = await getOwaToken();
+    if (!token)
+        throw new Error('Not authenticated. Run outlook_login first.');
+    let url = `${OWA_REST_V2}/me${path}`;
+    if (params) {
+        const qs = new URLSearchParams(params).toString();
+        url += (url.includes('?') ? '&' : '?') + qs;
+    }
+    const res = await fetchWithRetry(url, {
+        method: 'GET',
+        headers: getBearerHeaders(token, OWA_BASE),
+    });
+    return parseResponse(res);
+}
+export async function owaPost(path, body) {
+    const token = await getOwaToken();
+    if (!token)
+        throw new Error('Not authenticated. Run outlook_login first.');
+    const res = await fetchWithRetry(`${OWA_REST_V2}/me${path}`, {
+        method: 'POST',
+        headers: getBearerHeaders(token, OWA_BASE),
+        body: JSON.stringify(body),
+    });
+    return parseResponse(res);
+}
+export async function owaPatch(path, body) {
+    const token = await getOwaToken();
+    if (!token)
+        throw new Error('Not authenticated. Run outlook_login first.');
+    const res = await fetchWithRetry(`${OWA_REST_V2}/me${path}`, {
+        method: 'PATCH',
+        headers: getBearerHeaders(token, OWA_BASE),
+        body: JSON.stringify(body),
+    });
+    return parseResponse(res);
+}
+export async function owaDelete(path) {
+    const token = await getOwaToken();
+    if (!token)
+        throw new Error('Not authenticated. Run outlook_login first.');
+    const res = await fetchWithRetry(`${OWA_REST_V2}/me${path}`, {
+        method: 'DELETE',
+        headers: getBearerHeaders(token, OWA_BASE),
+    });
+    if (!res.ok && res.status !== 204) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`HTTP ${res.status}: ${text.slice(0, 200)}`);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Graph API client (fallback for some endpoints)
+// ─────────────────────────────────────────────────────────────────────────────
+export async function graphGet(path, params) {
+    const token = await getGraphToken();
+    if (!token)
+        throw new Error('Graph token unavailable. Run outlook_login first.');
+    let url = `${GRAPH_BASE}/me${path}`;
+    if (params) {
+        const qs = new URLSearchParams(params).toString();
+        url += (url.includes('?') ? '&' : '?') + qs;
+    }
+    const res = await fetchWithRetry(url, {
+        method: 'GET',
+        headers: getBearerHeaders(token),
+    });
+    return parseResponse(res);
+}
+export async function graphPost(path, body) {
+    const token = await getGraphToken();
+    if (!token)
+        throw new Error('Graph token unavailable. Run outlook_login first.');
+    const res = await fetchWithRetry(`${GRAPH_BASE}/me${path}`, {
+        method: 'POST',
+        headers: getBearerHeaders(token),
+        body: JSON.stringify(body),
+    });
+    return parseResponse(res);
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/contacts.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Contacts API.
+ */
+export interface Contact {
+    Id: string;
+    DisplayName: string;
+    GivenName?: string;
+    Surname?: string;
+    EmailAddresses?: Array<{
+        Name?: string;
+        Address: string;
+    }>;
+    BusinessPhones?: string[];
+    MobilePhone?: string;
+    JobTitle?: string;
+    CompanyName?: string;
+    Department?: string;
+    OfficeLocation?: string;
+    BusinessAddress?: {
+        Street?: string;
+        City?: string;
+        State?: string;
+        CountryOrRegion?: string;
+        PostalCode?: string;
+    };
+    Notes?: string;
+}
+export declare function listContacts(search?: string, top?: number): Promise<Contact[]>;
+export declare function getContact(id: string): Promise<Contact>;
+export interface CreateContactOptions {
+    givenName?: string;
+    surname?: string;
+    displayName?: string;
+    email?: string;
+    businessPhone?: string;
+    mobilePhone?: string;
+    jobTitle?: string;
+    companyName?: string;
+    notes?: string;
+}
+export declare function createContact(opts: CreateContactOptions): Promise<Contact>;
+export declare function deleteContact(id: string): Promise<void>;
+//# sourceMappingURL=contacts.d.ts.map

package/dist/api/contacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/api/contacts.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAsB,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAWhF;AAMD,wBAAsB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE7D;AAMD,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAchF;AAMD,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7D"}

package/dist/api/contacts.js

@@ -0,0 +1,45 @@
+/**
+ * Contacts API.
+ */
+import { owaGet, owaPost, owaDelete } from './client.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// List contacts
+// ─────────────────────────────────────────────────────────────────────────────
+export async function listContacts(search, top = 25) {
+    const params = {
+        '$top': String(top),
+        '$orderby': 'displayName asc',
+        '$select': 'Id,DisplayName,GivenName,Surname,EmailAddresses,BusinessPhones,MobilePhone,JobTitle,CompanyName',
+    };
+    if (search)
+        params['$search'] = `"${search}"`;
+    const res = await owaGet('/contacts', params);
+    return res.value;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Get contact
+// ─────────────────────────────────────────────────────────────────────────────
+export async function getContact(id) {
+    return owaGet(`/contacts/${id}`);
+}
+export async function createContact(opts) {
+    const emailAddresses = opts.email ? [{ Address: opts.email }] : undefined;
+    return owaPost('/contacts', {
+        GivenName: opts.givenName,
+        Surname: opts.surname,
+        DisplayName: opts.displayName ?? `${opts.givenName ?? ''} ${opts.surname ?? ''}`.trim(),
+        ...(emailAddresses ? { EmailAddresses: emailAddresses } : {}),
+        ...(opts.businessPhone ? { BusinessPhones: [opts.businessPhone] } : {}),
+        MobilePhone: opts.mobilePhone,
+        JobTitle: opts.jobTitle,
+        CompanyName: opts.companyName,
+        PersonalNotes: opts.notes,
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Delete contact
+// ─────────────────────────────────────────────────────────────────────────────
+export async function deleteContact(id) {
+    await owaDelete(`/contacts/${id}`);
+}
+//# sourceMappingURL=contacts.js.map

package/dist/api/contacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contacts.js","sourceRoot":"","sources":["../../src/api/contacts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA6BzD,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAe,EAAE,GAAG,GAAG,EAAE;IAC1D,MAAM,MAAM,GAA2B;QACrC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;QACnB,UAAU,EAAE,iBAAiB;QAC7B,SAAS,EAAE,iGAAiG;KAC7G,CAAC;IAEF,IAAI,MAAM;QAAE,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,MAAM,GAAG,CAAC;IAE9C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAyB,WAAW,EAAE,MAAM,CAAC,CAAC;IACtE,OAAO,GAAG,CAAC,KAAK,CAAC;AACnB,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,EAAU;IACzC,OAAO,MAAM,CAAU,aAAa,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAkBD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAA0B;IAC5D,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE1E,OAAO,OAAO,CAAU,WAAW,EAAE;QACnC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;QACvF,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,aAAa,EAAE,IAAI,CAAC,KAAK;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAU;IAC5C,MAAM,SAAS,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/api/mail.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Mail API — email CRUD, search, and folder operations.
+ */
+export interface EmailAddress {
+    Name: string;
+    Address: string;
+}
+export interface Recipient {
+    EmailAddress: EmailAddress;
+}
+export interface Message {
+    Id: string;
+    Subject: string;
+    BodyPreview?: string;
+    Body?: {
+        ContentType: string;
+        Content: string;
+    };
+    From?: Recipient;
+    Sender?: Recipient;
+    ToRecipients?: Recipient[];
+    CcRecipients?: Recipient[];
+    BccRecipients?: Recipient[];
+    ReceivedDateTime?: string;
+    SentDateTime?: string;
+    IsRead?: boolean;
+    HasAttachments?: boolean;
+    Importance?: string;
+    Flag?: {
+        FlagStatus: string;
+    };
+    ConversationId?: string;
+    ParentFolderId?: string;
+    WebLink?: string;
+    Attachments?: Attachment[];
+}
+export interface Attachment {
+    Id: string;
+    Name: string;
+    ContentType: string;
+    Size: number;
+    IsInline: boolean;
+}
+export interface MailFolder {
+    Id: string;
+    DisplayName: string;
+    UnreadItemCount: number;
+    TotalItemCount: number;
+    ChildFolderCount: number;
+}
+export interface ODataResponse<T> {
+    value: T[];
+    '@odata.nextLink'?: string;
+    '@odata.count'?: number;
+}
+export interface ListMessagesOptions {
+    folder?: string;
+    top?: number;
+    skip?: number;
+    filter?: string;
+    select?: string[];
+    orderBy?: string;
+    search?: string;
+}
+export declare function listMessages(opts?: ListMessagesOptions): Promise<Message[]>;
+export declare function getMessage(id: string, includeAttachments?: boolean): Promise<Message>;
+export interface SendEmailOptions {
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject: string;
+    body: string;
+    bodyType?: 'Text' | 'HTML';
+    importance?: 'Low' | 'Normal' | 'High';
+    saveToSentItems?: boolean;
+}
+export declare function sendEmail(opts: SendEmailOptions): Promise<void>;
+export declare function createDraft(opts: Omit<SendEmailOptions, 'saveToSentItems'>): Promise<Message>;
+export declare function replyToMessage(id: string, body: string, replyAll?: boolean): Promise<void>;
+export declare function forwardMessage(id: string, to: string[], comment?: string): Promise<void>;
+export declare function markMessageRead(id: string, isRead?: boolean): Promise<void>;
+export declare function flagMessage(id: string, status?: 'Flagged' | 'Complete' | 'NotFlagged'): Promise<void>;
+export declare function moveMessage(id: string, destinationFolderId: string): Promise<Message>;
+export declare function deleteMessage(id: string): Promise<void>;
+export declare function searchMessages(query: string, top?: number): Promise<Message[]>;
+export declare function listFolders(): Promise<MailFolder[]>;
+export declare function getFolder(idOrName: string): Promise<MailFolder>;
+export declare function getUnreadMessages(top?: number): Promise<Message[]>;
+export declare function sendDraft(draftId: string): Promise<void>;
+//# sourceMappingURL=mail.d.ts.map