@dashflow/ms365-mcp-server 1.0.0

package/src/endpoints.json

@@ -0,0 +1,596 @@
+[
+  {
+    "pathPattern": "/me/messages",
+    "method": "get",
+    "toolName": "list-mail-messages",
+    "scopes": ["Mail.Read"],
+    "llmTip": "CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search=\"your search query here\". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search=\"from:john@example.com\" | $search=\"subject:meeting AND hasAttachments:true\" | $search=\"body:urgent AND received>=2024-01-01\" | $search=\"from:john AND importance:high\". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter"
+  },
+  {
+    "pathPattern": "/me/mailFolders",
+    "method": "get",
+    "toolName": "list-mail-folders",
+    "scopes": ["Mail.Read"]
+  },
+  {
+    "pathPattern": "/me/mailFolders/{mailFolder-id}/messages",
+    "method": "get",
+    "toolName": "list-mail-folder-messages",
+    "scopes": ["Mail.Read"],
+    "llmTip": "CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search=\"your search query here\". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search=\"from:john@example.com\" | $search=\"subject:meeting AND hasAttachments:true\" | $search=\"body:urgent AND received>=2024-01-01\" | $search=\"from:alice AND importance:high\". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter"
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}",
+    "method": "get",
+    "toolName": "get-mail-message",
+    "scopes": ["Mail.Read"]
+  },
+  {
+    "pathPattern": "/me/sendMail",
+    "method": "post",
+    "toolName": "send-mail",
+    "scopes": ["Mail.Send"],
+    "llmTip": "CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients."
+  },
+  {
+    "pathPattern": "/users/{user-id}/messages",
+    "method": "get",
+    "toolName": "list-shared-mailbox-messages",
+    "workScopes": ["Mail.Read.Shared"],
+    "llmTip": "CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search=\"your search query here\". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search=\"from:john@example.com\" | $search=\"subject:meeting AND hasAttachments:true\" | $search=\"body:urgent AND received>=2024-01-01\" | $search=\"from:alice AND importance:high\". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter"
+  },
+  {
+    "pathPattern": "/users/{user-id}/mailFolders/{mailFolder-id}/messages",
+    "method": "get",
+    "toolName": "list-shared-mailbox-folder-messages",
+    "workScopes": ["Mail.Read.Shared"],
+    "llmTip": "CRITICAL: When searching emails, the $search parameter value MUST be wrapped in double quotes. Format: $search=\"your search query here\". Use KQL (Keyword Query Language) syntax to search specific properties: 'from:', 'subject:', 'body:', 'to:', 'cc:', 'bcc:', 'attachment:', 'hasAttachments:', 'importance:', 'received:', 'sent:'. Examples: $search=\"from:john@example.com\" | $search=\"subject:meeting AND hasAttachments:true\" | $search=\"body:urgent AND received>=2024-01-01\" | $search=\"from:alice AND importance:high\". Remember: ALWAYS wrap the entire search expression in double quotes! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter"
+  },
+  {
+    "pathPattern": "/users/{user-id}/messages/{message-id}",
+    "method": "get",
+    "toolName": "get-shared-mailbox-message",
+    "workScopes": ["Mail.Read.Shared"]
+  },
+  {
+    "pathPattern": "/users/{user-id}/sendMail",
+    "method": "post",
+    "toolName": "send-shared-mailbox-mail",
+    "workScopes": ["Mail.Send.Shared"],
+    "llmTip": "CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients."
+  },
+  {
+    "pathPattern": "/users",
+    "method": "get",
+    "toolName": "list-users",
+    "workScopes": ["User.Read.All"],
+    "llmTip": "CRITICAL: This request requires the ConsistencyLevel header set to eventual. When searching users, the $search parameter value MUST be wrapped in double quotes. Format: $search=\"your search query here\". Use KQL (Keyword Query Language) syntax to search specific properties: 'displayName:'. Examples: $search=\"displayName:john\" | $search=\"displayName:john\" OR \"displayName:jane\". Remember: ALWAYS wrap the entire search expression in double quotes and set the ConsistencyLevel header to eventual! Reference: https://learn.microsoft.com/en-us/graph/search-query-parameter"
+  },
+  {
+    "pathPattern": "/me/messages",
+    "method": "post",
+    "toolName": "create-draft-email",
+    "scopes": ["Mail.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}",
+    "method": "delete",
+    "toolName": "delete-mail-message",
+    "scopes": ["Mail.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}/move",
+    "method": "post",
+    "toolName": "move-mail-message",
+    "scopes": ["Mail.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}",
+    "method": "patch",
+    "toolName": "update-mail-message",
+    "scopes": ["Mail.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}/attachments",
+    "method": "post",
+    "toolName": "add-mail-attachment",
+    "scopes": ["Mail.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}/attachments",
+    "method": "get",
+    "toolName": "list-mail-attachments",
+    "scopes": ["Mail.Read"]
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}/attachments/{attachment-id}",
+    "method": "get",
+    "toolName": "get-mail-attachment",
+    "scopes": ["Mail.Read"]
+  },
+  {
+    "pathPattern": "/me/messages/{message-id}/attachments/{attachment-id}",
+    "method": "delete",
+    "toolName": "delete-mail-attachment",
+    "scopes": ["Mail.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/events",
+    "method": "get",
+    "toolName": "list-calendar-events",
+    "scopes": ["Calendars.Read"],
+    "supportsTimezone": true
+  },
+  {
+    "pathPattern": "/me/events/{event-id}",
+    "method": "get",
+    "toolName": "get-calendar-event",
+    "scopes": ["Calendars.Read"],
+    "supportsTimezone": true
+  },
+  {
+    "pathPattern": "/me/events",
+    "method": "post",
+    "toolName": "create-calendar-event",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients."
+  },
+  {
+    "pathPattern": "/me/events/{event-id}",
+    "method": "patch",
+    "toolName": "update-calendar-event",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients."
+  },
+  {
+    "pathPattern": "/me/events/{event-id}",
+    "method": "delete",
+    "toolName": "delete-calendar-event",
+    "scopes": ["Calendars.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/calendars/{calendar-id}/events",
+    "method": "get",
+    "toolName": "list-specific-calendar-events",
+    "scopes": ["Calendars.Read"],
+    "supportsTimezone": true
+  },
+  {
+    "pathPattern": "/me/calendars/{calendar-id}/events/{event-id}",
+    "method": "get",
+    "toolName": "get-specific-calendar-event",
+    "scopes": ["Calendars.Read"],
+    "supportsTimezone": true
+  },
+  {
+    "pathPattern": "/me/calendars/{calendar-id}/events",
+    "method": "post",
+    "toolName": "create-specific-calendar-event",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients."
+  },
+  {
+    "pathPattern": "/me/calendars/{calendar-id}/events/{event-id}",
+    "method": "patch",
+    "toolName": "update-specific-calendar-event",
+    "scopes": ["Calendars.ReadWrite"],
+    "llmTip": "CRITICAL: Do not try to guess the email address of the recipients. Use the list-users tool to find the email address of the recipients."
+  },
+  {
+    "pathPattern": "/me/calendars/{calendar-id}/events/{event-id}",
+    "method": "delete",
+    "toolName": "delete-specific-calendar-event",
+    "scopes": ["Calendars.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/calendarView",
+    "method": "get",
+    "toolName": "get-calendar-view",
+    "scopes": ["Calendars.Read"],
+    "supportsTimezone": true
+  },
+  {
+    "pathPattern": "/me/calendars",
+    "method": "get",
+    "toolName": "list-calendars",
+    "scopes": ["Calendars.Read"]
+  },
+  {
+    "pathPattern": "/me/findMeetingTimes",
+    "method": "post",
+    "toolName": "find-meeting-times",
+    "workScopes": ["Calendars.Read.Shared"]
+  },
+  {
+    "pathPattern": "/me/drives",
+    "method": "get",
+    "toolName": "list-drives",
+    "scopes": ["Files.Read"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/root",
+    "method": "get",
+    "toolName": "get-drive-root-item",
+    "scopes": ["Files.Read"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/root",
+    "method": "get",
+    "toolName": "get-root-folder",
+    "scopes": ["Files.Read"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/children",
+    "method": "get",
+    "toolName": "list-folder-files",
+    "scopes": ["Files.Read"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/content",
+    "method": "get",
+    "toolName": "download-onedrive-file-content",
+    "scopes": ["Files.Read"],
+    "returnDownloadUrl": true
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}",
+    "method": "delete",
+    "toolName": "delete-onedrive-file",
+    "scopes": ["Files.ReadWrite"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/content",
+    "method": "put",
+    "toolName": "upload-file-content",
+    "scopes": ["Files.ReadWrite"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/charts/add",
+    "method": "post",
+    "toolName": "create-excel-chart",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/format",
+    "method": "patch",
+    "toolName": "format-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range()/sort",
+    "method": "patch",
+    "toolName": "sort-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.ReadWrite"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets/{workbookWorksheet-id}/range(address='{address}')",
+    "method": "get",
+    "toolName": "get-excel-range",
+    "isExcelOp": true,
+    "scopes": ["Files.Read"]
+  },
+  {
+    "pathPattern": "/drives/{drive-id}/items/{driveItem-id}/workbook/worksheets",
+    "method": "get",
+    "toolName": "list-excel-worksheets",
+    "isExcelOp": true,
+    "scopes": ["Files.Read"]
+  },
+  {
+    "pathPattern": "/me/onenote/notebooks",
+    "method": "get",
+    "toolName": "list-onenote-notebooks",
+    "scopes": ["Notes.Read"]
+  },
+  {
+    "pathPattern": "/me/onenote/notebooks/{notebook-id}/sections",
+    "method": "get",
+    "toolName": "list-onenote-notebook-sections",
+    "scopes": ["Notes.Read"]
+  },
+  {
+    "pathPattern": "/me/onenote/sections/{onenoteSection-id}/pages",
+    "method": "get",
+    "toolName": "list-onenote-section-pages",
+    "scopes": ["Notes.Read"]
+  },
+  {
+    "pathPattern": "/me/onenote/pages/{onenotePage-id}/content",
+    "method": "get",
+    "toolName": "get-onenote-page-content",
+    "scopes": ["Notes.Read"]
+  },
+  {
+    "pathPattern": "/me/onenote/pages",
+    "method": "post",
+    "toolName": "create-onenote-page",
+    "scopes": ["Notes.Create"],
+    "contentType": "text/html"
+  },
+  {
+    "pathPattern": "/me/todo/lists",
+    "method": "get",
+    "toolName": "list-todo-task-lists",
+    "scopes": ["Tasks.Read"]
+  },
+  {
+    "pathPattern": "/me/todo/lists/{todoTaskList-id}/tasks",
+    "method": "get",
+    "toolName": "list-todo-tasks",
+    "scopes": ["Tasks.Read"]
+  },
+  {
+    "pathPattern": "/me/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}",
+    "method": "get",
+    "toolName": "get-todo-task",
+    "scopes": ["Tasks.Read"]
+  },
+  {
+    "pathPattern": "/me/todo/lists/{todoTaskList-id}/tasks",
+    "method": "post",
+    "toolName": "create-todo-task",
+    "scopes": ["Tasks.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}",
+    "method": "patch",
+    "toolName": "update-todo-task",
+    "scopes": ["Tasks.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/todo/lists/{todoTaskList-id}/tasks/{todoTask-id}",
+    "method": "delete",
+    "toolName": "delete-todo-task",
+    "scopes": ["Tasks.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/planner/tasks",
+    "method": "get",
+    "toolName": "list-planner-tasks",
+    "scopes": ["Tasks.Read"]
+  },
+  {
+    "pathPattern": "/planner/plans/{plannerPlan-id}",
+    "method": "get",
+    "toolName": "get-planner-plan",
+    "scopes": ["Tasks.Read"]
+  },
+  {
+    "pathPattern": "/planner/plans/{plannerPlan-id}/tasks",
+    "method": "get",
+    "toolName": "list-plan-tasks",
+    "scopes": ["Tasks.Read"]
+  },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}",
+    "method": "get",
+    "toolName": "get-planner-task",
+    "scopes": ["Tasks.Read"]
+  },
+  {
+    "pathPattern": "/planner/tasks",
+    "method": "post",
+    "toolName": "create-planner-task",
+    "scopes": ["Tasks.ReadWrite"]
+  },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}",
+    "method": "patch",
+    "toolName": "update-planner-task",
+    "scopes": ["Tasks.ReadWrite"]
+  },
+  {
+    "pathPattern": "/planner/tasks/{plannerTask-id}/details",
+    "method": "patch",
+    "toolName": "update-planner-task-details",
+    "scopes": ["Tasks.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/contacts",
+    "method": "get",
+    "toolName": "list-outlook-contacts",
+    "scopes": ["Contacts.Read"]
+  },
+  {
+    "pathPattern": "/me/contacts/{contact-id}",
+    "method": "get",
+    "toolName": "get-outlook-contact",
+    "scopes": ["Contacts.Read"]
+  },
+  {
+    "pathPattern": "/me/contacts",
+    "method": "post",
+    "toolName": "create-outlook-contact",
+    "scopes": ["Contacts.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/contacts/{contact-id}",
+    "method": "patch",
+    "toolName": "update-outlook-contact",
+    "scopes": ["Contacts.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/contacts/{contact-id}",
+    "method": "delete",
+    "toolName": "delete-outlook-contact",
+    "scopes": ["Contacts.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me",
+    "method": "get",
+    "toolName": "get-current-user",
+    "scopes": ["User.Read"]
+  },
+  {
+    "pathPattern": "/me/chats",
+    "method": "get",
+    "toolName": "list-chats",
+    "workScopes": ["Chat.Read"]
+  },
+  {
+    "pathPattern": "/chats/{chat-id}",
+    "method": "get",
+    "toolName": "get-chat",
+    "workScopes": ["Chat.Read"]
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages",
+    "method": "get",
+    "toolName": "list-chat-messages",
+    "workScopes": ["ChatMessage.Read"]
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages/{chatMessage-id}",
+    "method": "get",
+    "toolName": "get-chat-message",
+    "workScopes": ["ChatMessage.Read"]
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages",
+    "method": "post",
+    "toolName": "send-chat-message",
+    "workScopes": ["ChatMessage.Send"]
+  },
+  {
+    "pathPattern": "/me/joinedTeams",
+    "method": "get",
+    "toolName": "list-joined-teams",
+    "workScopes": ["Team.ReadBasic.All"]
+  },
+  {
+    "pathPattern": "/teams/{team-id}",
+    "method": "get",
+    "toolName": "get-team",
+    "workScopes": ["Team.ReadBasic.All"]
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels",
+    "method": "get",
+    "toolName": "list-team-channels",
+    "workScopes": ["Channel.ReadBasic.All"]
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels/{channel-id}",
+    "method": "get",
+    "toolName": "get-team-channel",
+    "workScopes": ["Channel.ReadBasic.All"]
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels/{channel-id}/messages",
+    "method": "get",
+    "toolName": "list-channel-messages",
+    "workScopes": ["ChannelMessage.Read.All"]
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels/{channel-id}/messages/{chatMessage-id}",
+    "method": "get",
+    "toolName": "get-channel-message",
+    "workScopes": ["ChannelMessage.Read.All"]
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels/{channel-id}/messages",
+    "method": "post",
+    "toolName": "send-channel-message",
+    "workScopes": ["ChannelMessage.Send"]
+  },
+  {
+    "pathPattern": "/teams/{team-id}/members",
+    "method": "get",
+    "toolName": "list-team-members",
+    "workScopes": ["TeamMember.Read.All"]
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages/{chatMessage-id}/replies",
+    "method": "get",
+    "toolName": "list-chat-message-replies",
+    "workScopes": ["ChatMessage.Read"]
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages/{chatMessage-id}/replies",
+    "method": "post",
+    "toolName": "reply-to-chat-message",
+    "workScopes": ["ChatMessage.Send"]
+  },
+  {
+    "pathPattern": "/sites",
+    "method": "get",
+    "toolName": "search-sharepoint-sites",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/drives",
+    "method": "get",
+    "toolName": "list-sharepoint-site-drives",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/drives/{drive-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site-drive-by-id",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/items",
+    "method": "get",
+    "toolName": "list-sharepoint-site-items",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/items/{baseItem-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site-item",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists",
+    "method": "get",
+    "toolName": "list-sharepoint-site-lists",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site-list",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/items",
+    "method": "get",
+    "toolName": "list-sharepoint-site-list-items",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/items/{listItem-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site-list-item",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/{site-id}/getByPath(path='{path}')",
+    "method": "get",
+    "toolName": "get-sharepoint-site-by-path",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/sites/delta()",
+    "method": "get",
+    "toolName": "get-sharepoint-sites-delta",
+    "workScopes": ["Sites.Read.All"]
+  },
+  {
+    "pathPattern": "/search/query",
+    "method": "post",
+    "toolName": "search-query",
+    "scopes": ["Mail.Read", "Calendars.Read", "Files.Read.All", "People.Read"],
+    "workScopes": ["Sites.Read.All", "Chat.Read", "ChannelMessage.Read.All"]
+  }
+]

package/src/generated/README.md

@@ -0,0 +1,56 @@
+# MS 365 OpenAPI Client Generation
+
+This directory contains the generated TypeScript client for the Microsoft 365 API based on the OpenAPI specification.
+
+## The Evolution
+
+### Version 1: AI-Generated Mappings
+
+Our initial approach used AI to map Microsoft 365 documentation and OpenAPI specifications directly into MCP tools with
+Zod mappings. While conceptually appealing, this approach didn't work well in practice and created several problems.
+
+### Version 2: Direct OpenAPI Spec Usage
+
+We then moved to using the full MS 365 OpenAPI specification file directly. This improved reliability but created new
+significant problems:
+
+- The spec file was a whopping 45MB in size
+- It had to be included in the npm package
+- Startup time was painfully slow due to parsing the large spec file
+
+### Version 3: Current Solution (Trimmed Spec + Generated Client)
+
+We eventually settled on a combined approach:
+
+- Trim the OpenAPI spec to only what we need
+- Generate static TypeScript client code using [openapi-zod-client](https://github.com/astahmer/openapi-zod-client)
+
+### Benefits
+
+- **Dramatically faster startup time** - No need to parse a large spec file
+- **Significantly smaller package size** - No more bundling a 45MB spec file
+- **Type safety** - Full TypeScript types generated from the OpenAPI spec
+- **Validation** - Zod schemas for request/response validation
+
+### Current Limitations & Future Improvements
+
+While this approach is a significant improvement, it's not perfect. The MCP server might still struggle to understand
+the MS 365 endpoints correctly, and there's room for improvements in how the API is exposed and documented for AI
+assistants. However, with the current foundation of generated TypeScript clients and proper type safety, these
+improvements should now be much easier to implement and maintain.
+
+## Regenerating the Client
+
+To regenerate the client code (e.g., after API changes or to update the supported endpoints):
+
+```
+npm run bin/generate-graph-client.mjs
+```
+
+This command does the following:
+
+1. Fetches/processes the OpenAPI spec
+2. Generates the TypeScript client with Zod validation
+3. Outputs the result to `client.ts` in this directory
+
+No complex build scripts needed - the generation is handled by openapi-zod-client.

package/src/generated/endpoint-types.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+
+export type HttpMethod = 'get' | 'post' | 'put' | 'delete' | 'patch';
+
+export type Parameter = {
+  name: string;
+  type: 'Query' | 'Path' | 'Body' | 'Header';
+  schema: z.ZodType<any>;
+  description?: string;
+};
+
+export type Endpoint = {
+  method: HttpMethod;
+  path: string;
+  alias: string;
+  description?: string;
+  requestFormat: 'json';
+  parameters?: Parameter[];
+  response: z.ZodType<any>;
+  errors?: Array<{
+    status: number;
+    description?: string;
+    schema?: z.ZodType<any>;
+  }>;
+};
+
+export type Endpoints = Endpoint[];