simply-outlook-mcp 0.0.1 → 0.0.3

package/dist/simply-outlook/graph-service.js

@@ -210,8 +210,9 @@ export class GraphService {
         const filterStr = filters.join(" and ");
         let query = this.graphClient.api("/me/messages").select(MAIL_PREVIEW_MESSAGE_PROPS).top(limit);
         // Graph search endpoint does not support MSA so use $search with limited functionalities
-        query = searchQuery
-            ? query.search(searchQuery)
+        const encodedQuery = searchQuery && encodeURIComponent(searchQuery);
+        query = encodedQuery
+            ? query.search(`"subject:${encodedQuery} OR body:${encodedQuery} OR from:${encodedQuery}"`)
             : query
                 .filter(filterStr)
                 .skip(skip || 0)

package/dist/tools/create-calendar-event-with-invite.js

@@ -4,11 +4,11 @@ export const CREATE_CALENDAR_EVENT_WITH_INVITE_TOOL_NAME = "create-calendar-even
 const DEFAULT_EVENT_DURATION_MINUTES = 30;
 export const registerCreateCalendarEventWithInviteTool = async (server, graphService) => {
     server.tool(CREATE_CALENDAR_EVENT_WITH_INVITE_TOOL_NAME, "Create a calendar event in Outlook and send invitations to specified attendees. Use this tool when you need to invite other people to the event.", {
-        subject: z.string().describe("The title/subject of the calendar event"),
-        content: z
+        userEmails: z
             .string()
-            .optional()
-            .describe("Optional description or body content for the event. Must be in markdown or plain text format."),
+            .array()
+            .describe("Array of email addresses to invite as attendees. Each attendee will receive a calendar invitation. Use empty array [] if no attendees should be invited."),
+        subject: z.string().describe("The title/subject of the calendar event"),
         startDateTime: z
             .string()
             .describe("The event start date and time in ISO format using local time zone. Format: 'YYYY-MM-DDTHH:mm:ss' (e.g., '2025-12-25T14:30:00')"),
@@ -20,10 +20,10 @@ export const registerCreateCalendarEventWithInviteTool = async (server, graphSer
             .string()
             .optional()
             .describe("Optional location or venue for the event (e.g., 'Conference Room A', 'Zoom Meeting', 'Central Park')"),
-        userEmails: z
+        content: z
             .string()
-            .array()
-            .describe("Array of email addresses to invite as attendees. Each attendee will receive a calendar invitation. Use empty array [] if no attendees should be invited."),
+            .optional()
+            .describe("Optional description or body content for the event. Must be in markdown or plain text format."),
         isMeeting: z
             .boolean()
             .optional()
@@ -39,7 +39,11 @@ export const registerCreateCalendarEventWithInviteTool = async (server, graphSer
             }
             const endDateTimeUtc = new Date(calculatedEndDateTime).toISOString();
             const eventData = await graphService.createCalendarEvent(subject, content || "", startDateTimeUtc, endDateTimeUtc, userEmails, location, isMeeting);
-            return textToolResult([`Event created successfully:`, JSON.stringify(toCalendarEventResult(eventData))]);
+            return textToolResult([
+                `Do not show the event ID to the user.`,
+                `Event created successfully:`,
+                JSON.stringify(toCalendarEventResult(eventData)),
+            ]);
         }
         catch (error) {
             return getErrorToolResult(error, "Failed to create calendar event.");

package/dist/tools/create-calendar-event.js

@@ -5,10 +5,6 @@ const DEFAULT_EVENT_DURATION_MINUTES = 30;
 export const registerCreateCalendarEventTool = async (server, graphService) => {
     server.tool(CREATE_CALENDAR_EVENT_TOOL_NAME, "Create a personal calendar event in Outlook without sending invitations to other attendees. This creates a private event only on the user's calendar.", {
         subject: z.string().describe("The title/subject of the calendar event"),
-        content: z
-            .string()
-            .optional()
-            .describe("Optional description or body content for the event. Must be in markdown or plain text format."),
         startDateTime: z
             .string()
             .describe("The event start date and time in ISO format using local time zone. Format: 'YYYY-MM-DDTHH:mm:ss' (e.g., '2025-12-25T14:30:00')"),
@@ -20,6 +16,10 @@ export const registerCreateCalendarEventTool = async (server, graphService) => {
             .string()
             .optional()
             .describe("Optional location or venue for the event (e.g., 'Conference Room A', 'Airport', 'Central Park')"),
+        content: z
+            .string()
+            .optional()
+            .describe("Optional description or body content for the event. Must be in markdown or plain text format."),
     }, async ({ subject, content, startDateTime, endDateTime, location }) => {
         try {
             const startDateTimeUtc = new Date(startDateTime).toISOString();
@@ -31,7 +31,11 @@ export const registerCreateCalendarEventTool = async (server, graphService) => {
             }
             const endDateTimeUtc = new Date(calculatedEndDateTime).toISOString();
             const eventData = await graphService.createCalendarEvent(subject, content || "", startDateTimeUtc, endDateTimeUtc, undefined, location);
-            return textToolResult([`Event created successfully:`, JSON.stringify(toCalendarEventResult(eventData))]);
+            return textToolResult([
+                `Do not show the event ID to the user.`,
+                `Event created successfully:`,
+                JSON.stringify(toCalendarEventResult(eventData)),
+            ]);
         }
         catch (error) {
             return getErrorToolResult(error, "Failed to create calendar event.");

package/dist/tools/get-calendar-events.js

@@ -51,7 +51,11 @@ export const registerGetCalendarEventsTool = async (server, graphService) => {
             if (!eventsData.length) {
                 return textToolResult(["No calendar events found."]);
             }
-            return textToolResult(["Calendar events found:", JSON.stringify(eventsData.map((event) => toCalendarEventResult(event)))]);
+            return textToolResult([
+                `Do not show the event ID to the user.`,
+                `There are ${eventsData.length} calendar events found:`,
+                JSON.stringify(eventsData.map((event) => toCalendarEventResult(event))),
+            ]);
         }
         catch (error) {
             return getErrorToolResult(error, "Failed to get calendar events.");

package/dist/tools/get-outlook-message-content.js

@@ -3,7 +3,9 @@ import { getErrorToolResult, textToolResult, toMailMessageResult } from "./tool-
 export const GET_OUTLOOK_MESSAGE_CONTENT_TOOL_NAME = "get-outlook-message-content";
 export const registerGetOutlookMessageContentTool = async (server, graphService) => {
     server.tool(GET_OUTLOOK_MESSAGE_CONTENT_TOOL_NAME, "Retrieve the full content of a specific Outlook mail message by its ID.", {
-        id: z.string().describe("The unique identifier of the mail message to retrieve the content for."),
+        id: z
+            .string()
+            .describe("The unique identifier of the mail message to retrieve the content for. This is a base64-encoded string that uniquely identifies the message in the user's mailbox. Preserve the exact ID format including any trailing '=' padding characters."),
     }, async ({ id }) => {
         try {
             const messageData = await graphService.getOutlookMessageById(id);

package/dist/tools/get-outlook-messages.js

@@ -36,7 +36,8 @@ export const registerGetOutlookMessagesTool = async (server, graphService) => {
                 return textToolResult(["No Outlook messages found."]);
             }
             return textToolResult([
-                `Outlook messages since ${utcDateTimeToLocal(receivedStartDateTimeUtc)}:`,
+                `Do not show the message ID to the user.`,
+                `There are ${messagesData.length} Outlook messages since ${utcDateTimeToLocal(receivedStartDateTimeUtc)}:`,
                 JSON.stringify(messagesData.map((message) => toMailMessageResult(message))),
             ]);
         }

package/dist/tools/reply-outlook-message.js

@@ -3,7 +3,9 @@ import { getErrorToolResult, textToolResult } from "./tool-utils.js";
 export const REPLY_OUTLOOK_MESSAGE_TOOL_NAME = "reply-outlook-message";
 export const registerReplyOutlookMessageTool = async (server, graphService) => {
     server.tool(REPLY_OUTLOOK_MESSAGE_TOOL_NAME, "Reply to an existing Outlook mail message with new content.", {
-        messageId: z.string().describe("The unique identifier of the mail message to reply to."),
+        messageId: z
+            .string()
+            .describe("The unique identifier of the mail message to reply to. This is a base64-encoded string that uniquely identifies the message in the user's mailbox. Preserve the exact ID format including any trailing '=' padding characters."),
         content: z
             .string()
             .describe("The reply content/body of the email message. Supports Markdown formatting which will be converted to HTML."),
@@ -16,7 +18,10 @@ export const registerReplyOutlookMessageTool = async (server, graphService) => {
                 throw new Error("Reply content cannot be empty.");
             }
             await graphService.replyOutlookMessage(messageId, content);
-            return textToolResult([`Successfully sent reply to Outlook message with ID: ${messageId}`]);
+            return textToolResult([
+                `Do not show the message ID to the user.`,
+                `Successfully sent reply to Outlook message with ID: ${messageId}`,
+            ]);
         }
         catch (error) {
             return getErrorToolResult(error, "Failed to reply to Outlook message.");

package/dist/tools/search-outlook-messages.js

@@ -23,7 +23,8 @@ export const registerSearchOutlookMessagesTool = async (server, graphService) =>
                 return textToolResult(["No Outlook messages found."]);
             }
             return textToolResult([
-                `Outlook messages matching keywords [${keywords}]:`,
+                `Do not show the message ID to the user.`,
+                `There are ${messagesData.length} Outlook messages matching keywords [${keywords}]:`,
                 JSON.stringify(messagesData.map((message) => toMailMessageResult(message))),
             ]);
         }

package/dist/tools/update-calendar-event.js

@@ -3,12 +3,10 @@ import { getErrorToolResult, textToolResult, toCalendarEventResult } from "./too
 export const UPDATE_CALENDAR_EVENT_TOOL_NAME = "update-calendar-event";
 export const registerUpdateCalendarEventTool = async (server, graphService) => {
     server.tool(UPDATE_CALENDAR_EVENT_TOOL_NAME, "Update an existing calendar event in Outlook. You can modify the subject, content, start/end times, or location. At least one field must be provided to update.", {
-        id: z.string().describe("The unique identifier of the calendar event to update"),
-        subject: z.string().optional().describe("Optional new title/subject for the calendar event"),
-        content: z
+        id: z
             .string()
-            .optional()
-            .describe("Optional new description or body content for the event. Must be in markdown or plain text format."),
+            .describe("This is a base64-encoded string that uniquely identifies the calendar event to update. Preserve the exact ID format including any trailing '=' padding characters."),
+        subject: z.string().optional().describe("Optional new title/subject for the calendar event"),
         startDateTime: z
             .string()
             .optional()
@@ -21,12 +19,20 @@ export const registerUpdateCalendarEventTool = async (server, graphService) => {
             .string()
             .optional()
             .describe("Optional new location or venue for the event (e.g., 'Conference Room A', 'Airport', 'Central Park'). Use empty string to remove location."),
+        content: z
+            .string()
+            .optional()
+            .describe("Optional new description or body content for the event. Must be in markdown or plain text format."),
     }, async ({ id, subject, content, startDateTime, endDateTime, location }) => {
         try {
             const startDateTimeUtc = startDateTime ? new Date(startDateTime).toISOString() : undefined;
             const endDateTimeUtc = endDateTime ? new Date(endDateTime).toISOString() : undefined;
             const eventData = await graphService.updateCalendarEvent(id, content, subject, startDateTimeUtc, endDateTimeUtc, location);
-            return textToolResult([`Calendar event updated successfully:`, JSON.stringify(toCalendarEventResult(eventData))]);
+            return textToolResult([
+                `Do not show the event ID to the user.`,
+                `Calendar event updated successfully:`,
+                JSON.stringify(toCalendarEventResult(eventData)),
+            ]);
         }
         catch (error) {
             return getErrorToolResult(error, "Failed to update calendar event.");

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.0.1";
+export declare const VERSION = "0.0.3";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = '0.0.1';
+export const VERSION = '0.0.3';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -19,7 +19,7 @@
     "type": "git",
     "url": "https://github.com/hmmroger/simply-outlook-mcp.git"
   },
-  "version": "0.0.1",
+  "version": "0.0.3",
   "files": [
     "dist/**/*.js",
     "dist/**/*.d.ts",