@softeria/ms-365-mcp-server 0.11.3 → 0.11.5

package/dist/cli.js

@@ -1,40 +1,39 @@
-import { Command } from 'commander';
-import { readFileSync } from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
+import { Command } from "commander";
+import { readFileSync } from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const packageJsonPath = path.join(__dirname, '..', 'package.json');
-const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+const packageJsonPath = path.join(__dirname, "..", "package.json");
+const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
 const version = packageJson.version;
 const program = new Command();
-program
-    .name('ms-365-mcp-server')
-    .description('Microsoft 365 MCP Server')
-    .version(version)
-    .option('-v', 'Enable verbose logging')
-    .option('--login', 'Login using device code flow')
-    .option('--logout', 'Log out and clear saved credentials')
-    .option('--verify-login', 'Verify login without starting the server')
-    .option('--list-accounts', 'List all cached accounts')
-    .option('--select-account <accountId>', 'Select a specific account by ID')
-    .option('--remove-account <accountId>', 'Remove a specific account by ID')
-    .option('--read-only', 'Start server in read-only mode, disabling write operations')
-    .option('--http [port]', 'Use Streamable HTTP transport instead of stdio (optionally specify port, default: 3000)')
-    .option('--enable-auth-tools', 'Enable login/logout tools when using HTTP mode (disabled by default in HTTP mode)')
-    .option('--enabled-tools <pattern>', 'Filter tools using regex pattern (e.g., "excel|contact" to enable Excel and Contact tools)')
-    .option('--force-work-scopes', 'Force inclusion of work account scopes during login (includes Teams, SharePoint, etc.)');
-export function parseArgs() {
-    program.parse();
-    const options = program.opts();
-    if (process.env.READ_ONLY === 'true' || process.env.READ_ONLY === '1') {
-        options.readOnly = true;
-    }
-    if (process.env.ENABLED_TOOLS) {
-        options.enabledTools = process.env.ENABLED_TOOLS;
-    }
-    if (process.env.MS365_MCP_FORCE_WORK_SCOPES === 'true' ||
-        process.env.MS365_MCP_FORCE_WORK_SCOPES === '1') {
-        options.forceWorkScopes = true;
-    }
-    return options;
+program.name("ms-365-mcp-server").description("Microsoft 365 MCP Server").version(version).option("-v", "Enable verbose logging").option("--login", "Login using device code flow").option("--logout", "Log out and clear saved credentials").option("--verify-login", "Verify login without starting the server").option("--list-accounts", "List all cached accounts").option("--select-account <accountId>", "Select a specific account by ID").option("--remove-account <accountId>", "Remove a specific account by ID").option("--read-only", "Start server in read-only mode, disabling write operations").option(
+  "--http [port]",
+  "Use Streamable HTTP transport instead of stdio (optionally specify port, default: 3000)"
+).option(
+  "--enable-auth-tools",
+  "Enable login/logout tools when using HTTP mode (disabled by default in HTTP mode)"
+).option(
+  "--enabled-tools <pattern>",
+  'Filter tools using regex pattern (e.g., "excel|contact" to enable Excel and Contact tools)'
+).option(
+  "--force-work-scopes",
+  "Force inclusion of work account scopes during login (includes Teams, SharePoint, etc.)"
+);
+function parseArgs() {
+  program.parse();
+  const options = program.opts();
+  if (process.env.READ_ONLY === "true" || process.env.READ_ONLY === "1") {
+    options.readOnly = true;
+  }
+  if (process.env.ENABLED_TOOLS) {
+    options.enabledTools = process.env.ENABLED_TOOLS;
+  }
+  if (process.env.MS365_MCP_FORCE_WORK_SCOPES === "true" || process.env.MS365_MCP_FORCE_WORK_SCOPES === "1") {
+    options.forceWorkScopes = true;
+  }
+  return options;
 }
+export {
+  parseArgs
+};

package/dist/endpoints.json

@@ -0,0 +1,490 @@
+[
+  {
+    "pathPattern": "/me/messages",
+    "method": "get",
+    "toolName": "list-mail-messages",
+    "scopes": ["Mail.Read"]
+  },
+  {
+    "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"]
+  },
+  {
+    "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"]
+  },
+  {
+    "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/events",
+    "method": "get",
+    "toolName": "list-calendar-events",
+    "scopes": ["Calendars.Read"]
+  },
+  {
+    "pathPattern": "/me/events/{event-id}",
+    "method": "get",
+    "toolName": "get-calendar-event",
+    "scopes": ["Calendars.Read"]
+  },
+  {
+    "pathPattern": "/me/events",
+    "method": "post",
+    "toolName": "create-calendar-event",
+    "scopes": ["Calendars.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/events/{event-id}",
+    "method": "patch",
+    "toolName": "update-calendar-event",
+    "scopes": ["Calendars.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/events/{event-id}",
+    "method": "delete",
+    "toolName": "delete-calendar-event",
+    "scopes": ["Calendars.ReadWrite"]
+  },
+  {
+    "pathPattern": "/me/calendarView",
+    "method": "get",
+    "toolName": "get-calendar-view",
+    "scopes": ["Calendars.Read"]
+  },
+  {
+    "pathPattern": "/me/calendars",
+    "method": "get",
+    "toolName": "list-calendars",
+    "scopes": ["Calendars.Read"]
+  },
+  {
+    "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}/children/{driveItem-id1}/content",
+    "method": "get",
+    "toolName": "download-onedrive-file-content",
+    "scopes": ["Files.Read"]
+  },
+  {
+    "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"]
+  },
+  {
+    "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": "/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",
+    "scopes": ["Chat.Read"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/chats/{chat-id}",
+    "method": "get",
+    "toolName": "get-chat",
+    "scopes": ["Chat.Read"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages",
+    "method": "get",
+    "toolName": "list-chat-messages",
+    "scopes": ["ChatMessage.Read"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages/{chatMessage-id}",
+    "method": "get",
+    "toolName": "get-chat-message",
+    "scopes": ["ChatMessage.Read"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages",
+    "method": "post",
+    "toolName": "send-chat-message",
+    "scopes": ["ChatMessage.Send"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/me/joinedTeams",
+    "method": "get",
+    "toolName": "list-joined-teams",
+    "scopes": ["Team.ReadBasic.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/teams/{team-id}",
+    "method": "get",
+    "toolName": "get-team",
+    "scopes": ["Team.ReadBasic.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels",
+    "method": "get",
+    "toolName": "list-team-channels",
+    "scopes": ["Channel.ReadBasic.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels/{channel-id}",
+    "method": "get",
+    "toolName": "get-team-channel",
+    "scopes": ["Channel.ReadBasic.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels/{channel-id}/messages",
+    "method": "get",
+    "toolName": "list-channel-messages",
+    "scopes": ["ChannelMessage.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels/{channel-id}/messages/{chatMessage-id}",
+    "method": "get",
+    "toolName": "get-channel-message",
+    "scopes": ["ChannelMessage.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/teams/{team-id}/channels/{channel-id}/messages",
+    "method": "post",
+    "toolName": "send-channel-message",
+    "scopes": ["ChannelMessage.Send"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/teams/{team-id}/members",
+    "method": "get",
+    "toolName": "list-team-members",
+    "scopes": ["TeamMember.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages/{chatMessage-id}/replies",
+    "method": "get",
+    "toolName": "list-chat-message-replies",
+    "scopes": ["ChatMessage.Read"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/chats/{chat-id}/messages/{chatMessage-id}/replies",
+    "method": "post",
+    "toolName": "reply-to-chat-message",
+    "scopes": ["ChatMessage.Send"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites",
+    "method": "get",
+    "toolName": "search-sharepoint-sites",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/drives",
+    "method": "get",
+    "toolName": "list-sharepoint-site-drives",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/drives/{drive-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site-drive-by-id",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/items",
+    "method": "get",
+    "toolName": "list-sharepoint-site-items",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/items/{baseItem-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site-item",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists",
+    "method": "get",
+    "toolName": "list-sharepoint-site-lists",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site-list",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/items",
+    "method": "get",
+    "toolName": "list-sharepoint-site-list-items",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/lists/{list-id}/items/{listItem-id}",
+    "method": "get",
+    "toolName": "get-sharepoint-site-list-item",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/{site-id}/getByPath(path='{path}')",
+    "method": "get",
+    "toolName": "get-sharepoint-site-by-path",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  },
+  {
+    "pathPattern": "/sites/delta()",
+    "method": "get",
+    "toolName": "get-sharepoint-sites-delta",
+    "scopes": ["Sites.Read.All"],
+    "requiresWorkAccount": true
+  }
+]