@chrischall/office-outlook-mcp 0.9.0 → 0.10.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Outlook / Microsoft 365 — mail, calendar, contacts and tasks via natural language",
-    "version": "0.9.0"
+    "version": "0.10.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Outlook (Microsoft 365)",
       "source": "./",
       "description": "MCP server for Outlook / Microsoft 365 — triage unread mail, reply, answer meeting invites and schedule meetings, plus folders, calendar, contacts and tasks, with confirmation before anything is sent",
-      "version": "0.9.0",
+      "version": "0.10.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "office-outlook-mcp",
   "displayName": "Outlook (Microsoft 365)",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Outlook / Microsoft 365 for Claude — triage unread mail, reply, answer meeting invites and schedule meetings, plus folders, calendar, contacts and tasks, with confirmation before anything is sent, using your signed-in browser session",
   "author": {
     "name": "Chris Hall",

package/dist/bundle.js

@@ -39293,7 +39293,7 @@ var init_version = __esm({
   "src/version.ts"() {
     "use strict";
     PACKAGE_NAME = "office-outlook-mcp";
-    VERSION = "0.9.0";
+    VERSION = "0.10.0";
   }
 });
 
@@ -68470,13 +68470,17 @@ function compactEvent(e) {
     ShowAs: e.ShowAs
   });
 }
+function eventAttendees(e) {
+  return e.Attendees?.map((a) => pruned({ Who: addr(a), Response: a.Status?.Response }));
+}
+function detailedEvent(e) {
+  return pruned({ ...compactEvent(e), Attendees: eventAttendees(e) });
+}
 function fullEvent(e) {
   return pruned({
     ...compactEvent(e),
     SeriesMasterId: e.SeriesMasterId,
-    Attendees: e.Attendees?.map(
-      (a) => pruned({ Who: addr(a), Response: a.Status?.Response })
-    ),
+    Attendees: eventAttendees(e),
     // The Teams link lives under OnlineMeeting; OnlineMeetingUrl is empty on
     // every live Teams meeting checked.
     JoinUrl: e.OnlineMeeting?.JoinUrl || e.OnlineMeetingUrl || void 0,
@@ -69199,7 +69203,7 @@ function registerCalendarTools(server, client2) {
   server.registerTool(
     "outlook_get_event",
     {
-      description: `Get one calendar event in full, including attendees and their responses. Attendees appear in view:"full", every one of them \u2014 there is no 20-address cap as on a message's To/Cc; view:"raw" returns Outlook's untouched record, uncapped, Attendees included. ` + UNTRUSTED_DESCRIPTION_SUFFIX,
+      description: 'Get one calendar event with its attendees and their responses. Attendees come back in EVERY view, including the default compact one \u2014 all of them, uncapped (no 20-address cap as on a message\'s To/Cc). The event\'s time is labelled with its zone in the `TimeZone` field (the mailbox zone unless you pass `timeZone`); the same instant read in another zone shows a different clock time, so read `TimeZone`, not just the clock. view:"full" adds the Teams join link, body preview and web link; view:"raw" returns Outlook\'s untouched record. ' + UNTRUSTED_DESCRIPTION_SUFFIX,
       annotations: { readOnlyHint: true, openWorldHint: true },
       _meta: workMeta("lookup"),
       inputSchema: external_exports.object({
@@ -69216,7 +69220,7 @@ function registerCalendarTools(server, client2) {
       );
       const v = resolveView(view, VIEWS2);
       if (v === "raw") return mailboxUntrusted(data);
-      return mailboxUntrusted(v === "compact" ? compactEvent(data) : fullEvent(data));
+      return mailboxUntrusted(v === "full" ? fullEvent(data) : detailedEvent(data));
     }
   );
   server.registerTool(
@@ -71631,7 +71635,7 @@ function decodeJwt(token) {
   return { oid: claims.oid, tid: claims.tid };
 }
 function cleanAnswer(text) {
-  return text.replace(/[\u{E000}-\u{F8FF}\u{F0000}-\u{FFFFD}\u{100000}-\u{10FFFD}]/gu, "").replace(/cite(?:turn\d+[a-z]+\d+)+/gi, "").replace(/【[^】]{1,60}】/g, "").replace(/[ \t]+\n/g, "\n").replace(/[ \t]{2,}/g, " ").trim();
+  return text.replace(/[\u{E000}-\u{F8FF}\u{F0000}-\u{FFFFD}\u{100000}-\u{10FFFD}]/gu, "").replace(/cite(?:turn\d+[a-z]+\d+)+/gi, "").replace(/【[^】]{1,60}】/g, "").replace(/[ \t]+\n/g, "\n").replace(/(\S)[ \t]{2,}/g, "$1 ").trim();
 }
 var DisengagedError = class extends Error {
   disengaged = true;
@@ -71898,6 +71902,12 @@ function abortError() {
 }
 
 // src/tools/copilot.ts
+async function timeContext(outlook) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const zone = await mailboxTimeZone(outlook);
+  return zone ? `(Context: today is ${today}. The user's mailbox time zone is ${zone}, and mailbox times are stored in UTC. When you state any date or time, convert it to ${zone} and label the zone.)` : `(Context: today is ${today}. Mailbox times are stored in UTC \u2014 when you state a time, label its time zone.)`;
+}
+var VERBATIM_DIRECTIVE = "(Reproduce any content I ask you to quote or return IN FULL and verbatim \u2014 do not summarise, paraphrase, shorten, or omit any part of it, even if it is long.)";
 var TURN_TIMEOUT_MS = 12e4;
 function turnSignal(hostSignal) {
   const controller = new AbortController();
@@ -71916,23 +71926,27 @@ function turnSignal(hostSignal) {
     }
   };
 }
-function registerCopilotTools(server, copilot2) {
+function registerCopilotTools(server, copilot2, outlook) {
   server.registerTool(
     "outlook_ask_copilot",
     {
-      description: 'Ask Microsoft 365 Copilot a question answered from the signed-in mailbox (Copilot searches your own mail, calendar and files server-side and writes a reply). Use it for synthesis across many messages \u2014 "what needs my attention first", "summarise the thread with X", "did anyone ask me for anything this week". Follow-up calls continue the same conversation; pass newConversation:true to start fresh. The prompt is sent to Microsoft\'s Copilot service on your tenant; put your own question in it, not text copied from an email. Each call uses one of a per-conversation quota, reported back. First use needs a one-time sign-in: run `opencode-m365 login` (from the opencode-m365-copilot package) so an MSAL cache exists.' + UNTRUSTED_DESCRIPTION_SUFFIX,
+      description: 'Ask Microsoft 365 Copilot a question answered from the signed-in mailbox (Copilot searches your own mail, calendar and files server-side and writes a reply). Use it for synthesis across many messages \u2014 "what needs my attention first", "summarise the thread with X", "did anyone ask me for anything this week". Follow-up calls continue the same conversation; pass newConversation:true to start fresh. Pass verbatim:true when you need content quoted back in full (Copilot otherwise answers concisely and summarises long material; for a single item a focused "quote X in full" also works). Times are converted to the mailbox time zone and labelled. The prompt is sent to Microsoft\'s Copilot service on your tenant; put your own question in it, not text copied from an email. Each call uses one of a per-conversation quota, reported back. First use needs a one-time sign-in: run `opencode-m365 login` (from the opencode-m365-copilot package) so an MSAL cache exists.' + UNTRUSTED_DESCRIPTION_SUFFIX,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
       _meta: workMeta("lookup", { aliases: ["copilot", "ask copilot", "m365 copilot"] }),
       inputSchema: external_exports.object({
         prompt: external_exports.string().min(1).describe("The question for Copilot, in your own words"),
-        newConversation: external_exports.boolean().optional().describe("Start a fresh conversation with no prior context (default false: continue the current one)")
+        newConversation: external_exports.boolean().optional().describe("Start a fresh conversation with no prior context (default false: continue the current one)"),
+        verbatim: external_exports.boolean().optional().describe("Ask Copilot to quote requested content in full rather than summarising (default false). Use for retrieving a saved note, a full message, etc.")
       })
     },
-    async ({ prompt, newConversation }, ctx) => {
+    async ({ prompt, newConversation, verbatim }, ctx) => {
       if (newConversation) copilot2.reset();
       const { signal, dispose } = turnSignal(ctx?.signal);
       try {
-        const result = await copilot2.ask(prompt, { signal });
+        const preamble = [await timeContext(outlook), verbatim ? VERBATIM_DIRECTIVE : ""].filter(Boolean).join(" ");
+        const result = await copilot2.ask(`${preamble}
+
+${prompt}`, { signal });
         return mailboxUntrusted({
           answer: result.text,
           conversationId: copilot2.conversationId,
@@ -72090,7 +72104,7 @@ await runMcp({
     registerWriteTools,
     registerExportTools,
     registerRuleTools,
-    (server) => registerCopilotTools(server, copilot),
+    (server) => registerCopilotTools(server, copilot, client),
     registerHealthcheckTool
   ]
 });

package/dist/copilot/session.js

@@ -98,7 +98,10 @@ export function cleanAnswer(text) {
         .replace(/cite(?:turn\d+[a-z]+\d+)+/gi, '')
         .replace(/【[^】]{1,60}】/g, '')
         .replace(/[ \t]+\n/g, '\n')
-        .replace(/[ \t]{2,}/g, ' ')
+        // Collapse only runs that FOLLOW a non-space character (the double spaces a
+        // removed token leaves mid-line), never leading indentation — a Copilot
+        // answer can quote an indented code block from a mail or note.
+        .replace(/(\S)[ \t]{2,}/g, '$1 ')
         .trim();
 }
 /** M365 refused to engage with the prompt. Not a rate limit — do not retry into it. */

package/dist/index.js

@@ -45,7 +45,7 @@ await runMcp({
         registerWriteTools,
         registerExportTools,
         registerRuleTools,
-        (server) => registerCopilotTools(server, copilot),
+        (server) => registerCopilotTools(server, copilot, client),
         registerHealthcheckTool,
     ],
 });

package/dist/tools/calendar.js

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { McpToolError, minifiedResult, resolveView, viewParam } from '@chrischall/mcp-utils';
 import { mailboxUntrusted, UNTRUSTED_DESCRIPTION_SUFFIX } from './_untrusted.js';
 import { briefDate, briefLine, briefResult, briefViewParam, spaced, workMeta } from './_hints.js';
-import { compactEvent, fullEvent, projectCollection, VIEWS, } from '../view.js';
+import { compactEvent, detailedEvent, fullEvent, projectCollection, VIEWS, } from '../view.js';
 import { fetchPage, nextLinkParam, plainCollection } from './_paging.js';
 import { mailboxTimeZone } from '../timezone.js';
 const EVENT_SELECT = 'Id,Subject,Start,End,Location,Organizer,IsAllDay,IsCancelled,ShowAs,OnlineMeetingUrl,OnlineMeeting,BodyPreview,' +
@@ -89,7 +89,7 @@ export function registerCalendarTools(server, client) {
         return mailboxUntrusted(projectCollection(data, v === 'full' ? fullEvent : compactEvent, 'event'));
     });
     server.registerTool('outlook_get_event', {
-        description: 'Get one calendar event in full, including attendees and their responses. Attendees appear in view:"full", every one of them — there is no 20-address cap as on a message\'s To/Cc; view:"raw" returns Outlook\'s untouched record, uncapped, Attendees included.' +
+        description: 'Get one calendar event with its attendees and their responses. Attendees come back in EVERY view, including the default compact one — all of them, uncapped (no 20-address cap as on a message\'s To/Cc). The event\'s time is labelled with its zone in the `TimeZone` field (the mailbox zone unless you pass `timeZone`); the same instant read in another zone shows a different clock time, so read `TimeZone`, not just the clock. view:"full" adds the Teams join link, body preview and web link; view:"raw" returns Outlook\'s untouched record.' +
             ' ' + UNTRUSTED_DESCRIPTION_SUFFIX,
         annotations: { readOnlyHint: true, openWorldHint: true },
         _meta: workMeta('lookup'),
@@ -104,7 +104,7 @@ export function registerCalendarTools(server, client) {
         const v = resolveView(view, VIEWS);
         if (v === 'raw')
             return mailboxUntrusted(data);
-        return mailboxUntrusted(v === 'compact' ? compactEvent(data) : fullEvent(data));
+        return mailboxUntrusted(v === 'full' ? fullEvent(data) : detailedEvent(data));
     });
     server.registerTool('outlook_list_calendars', {
         description: 'List the calendars in the mailbox, for picking one to read or write against.',

package/dist/tools/copilot.js

@@ -14,8 +14,28 @@
 import { z } from 'zod';
 import { minifiedResult } from '@chrischall/mcp-utils';
 import { DisengagedError } from '../copilot/session.js';
+import { mailboxTimeZone } from '../timezone.js';
 import { workMeta } from './_hints.js';
 import { mailboxUntrusted, UNTRUSTED_DESCRIPTION_SUFFIX } from './_untrusted.js';
+/**
+ * A short context preamble prepended to every Copilot prompt.
+ *
+ * Copilot renders a stored UTC time as a bare clock with no zone — a 2026-11-09
+ * UTC time came back as "11:41 AM", which reads as local but is not. Telling it
+ * today's date and the mailbox zone, and to convert and label, fixes the
+ * labelling at the source. The mailbox zone is read once (cached per client); if
+ * it cannot be read — a server set up for Copilot but not the Outlook mail
+ * token — the instruction degrades to "label the zone" with no date-math hint.
+ */
+async function timeContext(outlook) {
+    const today = new Date().toISOString().slice(0, 10);
+    const zone = await mailboxTimeZone(outlook);
+    return zone
+        ? `(Context: today is ${today}. The user's mailbox time zone is ${zone}, and mailbox times are stored in UTC. When you state any date or time, convert it to ${zone} and label the zone.)`
+        : `(Context: today is ${today}. Mailbox times are stored in UTC — when you state a time, label its time zone.)`;
+}
+/** The extra instruction a verbatim request prepends. */
+const VERBATIM_DIRECTIVE = "(Reproduce any content I ask you to quote or return IN FULL and verbatim — do not summarise, paraphrase, shorten, or omit any part of it, even if it is long.)";
 /** Stop a turn that outlives this, so a wedged connection cannot hang the call. */
 const TURN_TIMEOUT_MS = 120_000;
 /**
@@ -41,9 +61,9 @@ function turnSignal(hostSignal) {
         },
     };
 }
-export function registerCopilotTools(server, copilot) {
+export function registerCopilotTools(server, copilot, outlook) {
     server.registerTool('outlook_ask_copilot', {
-        description: 'Ask Microsoft 365 Copilot a question answered from the signed-in mailbox (Copilot searches your own mail, calendar and files server-side and writes a reply). Use it for synthesis across many messages — "what needs my attention first", "summarise the thread with X", "did anyone ask me for anything this week". Follow-up calls continue the same conversation; pass newConversation:true to start fresh. The prompt is sent to Microsoft\'s Copilot service on your tenant; put your own question in it, not text copied from an email. Each call uses one of a per-conversation quota, reported back. First use needs a one-time sign-in: run `opencode-m365 login` (from the opencode-m365-copilot package) so an MSAL cache exists.' +
+        description: 'Ask Microsoft 365 Copilot a question answered from the signed-in mailbox (Copilot searches your own mail, calendar and files server-side and writes a reply). Use it for synthesis across many messages — "what needs my attention first", "summarise the thread with X", "did anyone ask me for anything this week". Follow-up calls continue the same conversation; pass newConversation:true to start fresh. Pass verbatim:true when you need content quoted back in full (Copilot otherwise answers concisely and summarises long material; for a single item a focused "quote X in full" also works). Times are converted to the mailbox time zone and labelled. The prompt is sent to Microsoft\'s Copilot service on your tenant; put your own question in it, not text copied from an email. Each call uses one of a per-conversation quota, reported back. First use needs a one-time sign-in: run `opencode-m365 login` (from the opencode-m365-copilot package) so an MSAL cache exists.' +
             UNTRUSTED_DESCRIPTION_SUFFIX,
         annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
         _meta: workMeta('lookup', { aliases: ['copilot', 'ask copilot', 'm365 copilot'] }),
@@ -53,13 +73,20 @@ export function registerCopilotTools(server, copilot) {
                 .boolean()
                 .optional()
                 .describe('Start a fresh conversation with no prior context (default false: continue the current one)'),
+            verbatim: z
+                .boolean()
+                .optional()
+                .describe('Ask Copilot to quote requested content in full rather than summarising (default false). Use for retrieving a saved note, a full message, etc.'),
         }),
-    }, async ({ prompt, newConversation }, ctx) => {
+    }, async ({ prompt, newConversation, verbatim }, ctx) => {
         if (newConversation)
             copilot.reset();
         const { signal, dispose } = turnSignal(ctx?.signal);
         try {
-            const result = await copilot.ask(prompt, { signal });
+            const preamble = [await timeContext(outlook), verbatim ? VERBATIM_DIRECTIVE : '']
+                .filter(Boolean)
+                .join(' ');
+            const result = await copilot.ask(`${preamble}\n\n${prompt}`, { signal });
             return mailboxUntrusted({
                 answer: result.text,
                 conversationId: copilot.conversationId,

package/dist/version.js

@@ -10,4 +10,4 @@
  * line below and nowhere else — not even in prose.
  */
 export const PACKAGE_NAME = 'office-outlook-mcp';
-export const VERSION = '0.9.0'; // x-release-please-version
+export const VERSION = '0.10.0'; // x-release-please-version

package/dist/view.js

@@ -100,11 +100,28 @@ export function compactEvent(e) {
         ShowAs: e.ShowAs,
     });
 }
+/** Attendees projected as `{ Who, Response }`, or undefined when there are none. */
+export function eventAttendees(e) {
+    return e.Attendees?.map((a) => pruned({ Who: addr(a), Response: a.Status?.Response }));
+}
+/**
+ * A single event's compact view WITH its attendees — what outlook_get_event
+ * returns by default.
+ *
+ * A single event is not a list, so the per-item cap that keeps attendees off
+ * list_events (one `calendarview` page can hold dozens of events) does not
+ * apply, and the attendees are the point of looking one event up. list_events
+ * still uses the attendee-free {@link compactEvent}; only get_event carries them
+ * in its compact view, as its description promises.
+ */
+export function detailedEvent(e) {
+    return pruned({ ...compactEvent(e), Attendees: eventAttendees(e) });
+}
 export function fullEvent(e) {
     return pruned({
         ...compactEvent(e),
         SeriesMasterId: e.SeriesMasterId,
-        Attendees: e.Attendees?.map((a) => pruned({ Who: addr(a), Response: a.Status?.Response })),
+        Attendees: eventAttendees(e),
         // The Teams link lives under OnlineMeeting; OnlineMeetingUrl is empty on
         // every live Teams meeting checked.
         JoinUrl: e.OnlineMeeting?.JoinUrl || e.OnlineMeetingUrl || undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrischall/office-outlook-mcp",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "mcpName": "io.github.chrischall/office-outlook-mcp",
   "description": "Outlook / Microsoft 365 MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/office-outlook-mcp",
     "source": "github"
   },
-  "version": "0.9.0",
+  "version": "0.10.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@chrischall/office-outlook-mcp",
-      "version": "0.9.0",
+      "version": "0.10.0",
       "transport": {
         "type": "stdio"
       },