@softeria/ms-365-mcp-server 0.47.0 → 0.47.2

package/dist/auth.js

@@ -48,6 +48,30 @@ function ensureParentDir(filePath) {
   const dir = path.dirname(filePath);
   fs.mkdirSync(dir, { recursive: true, mode: 448 });
 }
+function wrapCache(data) {
+  return JSON.stringify({ _cacheEnvelope: true, data, savedAt: Date.now() });
+}
+function unwrapCache(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed._cacheEnvelope && typeof parsed.data === "string") {
+      return { data: parsed.data, savedAt: parsed.savedAt };
+    }
+  } catch {
+  }
+  return { data: raw };
+}
+function pickNewest(keytarRaw, fileRaw) {
+  if (!keytarRaw && !fileRaw) return void 0;
+  if (keytarRaw && !fileRaw) return unwrapCache(keytarRaw).data;
+  if (!keytarRaw && fileRaw) return unwrapCache(fileRaw).data;
+  const kt = unwrapCache(keytarRaw);
+  const file = unwrapCache(fileRaw);
+  if (kt.savedAt === void 0 && file.savedAt === void 0) return kt.data;
+  if (kt.savedAt !== void 0 && file.savedAt === void 0) return kt.data;
+  if (kt.savedAt === void 0 && file.savedAt !== void 0) return file.data;
+  return kt.savedAt >= file.savedAt ? kt.data : file.data;
+}
 function createMsalConfig(secrets) {
   const cloudEndpoints = getCloudEndpoints(secrets.cloudType);
   return {
@@ -126,24 +150,21 @@ class AuthManager {
   }
   async loadTokenCache() {
     try {
-      let cacheData;
+      let keytarRaw;
       try {
         const kt = await getKeytar();
         if (kt) {
-          const cachedData = await kt.getPassword(SERVICE_NAME, TOKEN_CACHE_ACCOUNT);
-          if (cachedData) {
-            cacheData = cachedData;
-          }
+          keytarRaw = await kt.getPassword(SERVICE_NAME, TOKEN_CACHE_ACCOUNT) ?? void 0;
         }
       } catch (keytarError) {
-        logger.warn(
-          `Keychain access failed, falling back to file storage: ${keytarError.message}`
-        );
+        logger.warn(`Keychain access failed: ${keytarError.message}`);
       }
+      let fileRaw;
       const cachePath = getTokenCachePath();
-      if (!cacheData && existsSync(cachePath)) {
-        cacheData = readFileSync(cachePath, "utf8");
+      if (existsSync(cachePath)) {
+        fileRaw = readFileSync(cachePath, "utf8");
       }
+      const cacheData = pickNewest(keytarRaw, fileRaw);
       if (cacheData) {
         this.msalApp.getTokenCache().deserialize(cacheData);
       }
@@ -154,24 +175,23 @@ class AuthManager {
   }
   async loadSelectedAccount() {
     try {
-      let selectedAccountData;
+      let keytarRaw;
       try {
         const kt = await getKeytar();
         if (kt) {
-          const cachedData = await kt.getPassword(SERVICE_NAME, SELECTED_ACCOUNT_KEY);
-          if (cachedData) {
-            selectedAccountData = cachedData;
-          }
+          keytarRaw = await kt.getPassword(SERVICE_NAME, SELECTED_ACCOUNT_KEY) ?? void 0;
         }
       } catch (keytarError) {
         logger.warn(
-          `Keychain access failed for selected account, falling back to file storage: ${keytarError.message}`
+          `Keychain access failed for selected account: ${keytarError.message}`
         );
       }
+      let fileRaw;
       const accountPath = getSelectedAccountPath();
-      if (!selectedAccountData && existsSync(accountPath)) {
-        selectedAccountData = readFileSync(accountPath, "utf8");
+      if (existsSync(accountPath)) {
+        fileRaw = readFileSync(accountPath, "utf8");
       }
+      const selectedAccountData = pickNewest(keytarRaw, fileRaw);
       if (selectedAccountData) {
         const parsed = JSON.parse(selectedAccountData);
         this.selectedAccountId = parsed.accountId;
@@ -183,15 +203,15 @@ class AuthManager {
   }
   async saveTokenCache() {
     try {
-      const cacheData = this.msalApp.getTokenCache().serialize();
+      const stamped = wrapCache(this.msalApp.getTokenCache().serialize());
       try {
         const kt = await getKeytar();
         if (kt) {
-          await kt.setPassword(SERVICE_NAME, TOKEN_CACHE_ACCOUNT, cacheData);
+          await kt.setPassword(SERVICE_NAME, TOKEN_CACHE_ACCOUNT, stamped);
         } else {
           const cachePath = getTokenCachePath();
           ensureParentDir(cachePath);
-          fs.writeFileSync(cachePath, cacheData, { mode: 384 });
+          fs.writeFileSync(cachePath, stamped, { mode: 384 });
         }
       } catch (keytarError) {
         logger.warn(
@@ -199,7 +219,7 @@ class AuthManager {
         );
         const cachePath = getTokenCachePath();
         ensureParentDir(cachePath);
-        fs.writeFileSync(cachePath, cacheData, { mode: 384 });
+        fs.writeFileSync(cachePath, stamped, { mode: 384 });
       }
     } catch (error) {
       logger.error(`Error saving token cache: ${error.message}`);
@@ -207,15 +227,15 @@ class AuthManager {
   }
   async saveSelectedAccount() {
     try {
-      const selectedAccountData = JSON.stringify({ accountId: this.selectedAccountId });
+      const stamped = wrapCache(JSON.stringify({ accountId: this.selectedAccountId }));
       try {
         const kt = await getKeytar();
         if (kt) {
-          await kt.setPassword(SERVICE_NAME, SELECTED_ACCOUNT_KEY, selectedAccountData);
+          await kt.setPassword(SERVICE_NAME, SELECTED_ACCOUNT_KEY, stamped);
         } else {
           const accountPath = getSelectedAccountPath();
           ensureParentDir(accountPath);
-          fs.writeFileSync(accountPath, selectedAccountData, { mode: 384 });
+          fs.writeFileSync(accountPath, stamped, { mode: 384 });
         }
       } catch (keytarError) {
         logger.warn(
@@ -223,7 +243,7 @@ class AuthManager {
         );
         const accountPath = getSelectedAccountPath();
         ensureParentDir(accountPath);
-        fs.writeFileSync(accountPath, selectedAccountData, { mode: 384 });
+        fs.writeFileSync(accountPath, stamped, { mode: 384 });
       }
     } catch (error) {
       logger.error(`Error saving selected account: ${error.message}`);
@@ -524,5 +544,8 @@ export {
   buildScopesFromEndpoints,
   auth_default as default,
   getSelectedAccountPath,
-  getTokenCachePath
+  getTokenCachePath,
+  pickNewest,
+  unwrapCache,
+  wrapCache
 };

package/dist/endpoints.json

@@ -658,6 +658,55 @@
     "toolName": "list-team-members",
     "workScopes": ["TeamMember.Read.All"]
   },
+  {
+    "pathPattern": "/teams/{team-id}/tags",
+    "method": "get",
+    "toolName": "list-team-tags",
+    "workScopes": ["TeamworkTag.Read"],
+    "llmTip": "List all tags in a team. Returns tag id, displayName, memberCount, and tagType (standard or scheduled). Use list-joined-teams to find the team ID first."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags",
+    "method": "post",
+    "toolName": "create-team-tag",
+    "workScopes": ["TeamworkTag.ReadWrite"],
+    "llmTip": "Create a new tag in a team. Body requires displayName (max 40 chars) and an optional members array (max 25 at creation, each with a userId). Use list-team-members to find user IDs. Add more members individually with add-team-tag-member after creation."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}",
+    "method": "get",
+    "toolName": "get-team-tag",
+    "workScopes": ["TeamworkTag.Read"],
+    "llmTip": "Get details of a specific tag including displayName, memberCount, and tagType. Use list-team-tags to find the tag ID."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}",
+    "method": "patch",
+    "toolName": "update-team-tag",
+    "workScopes": ["TeamworkTag.ReadWrite"],
+    "llmTip": "Update a tag's displayName (max 40 chars). Use list-team-tags to find the tag ID."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}",
+    "method": "delete",
+    "toolName": "delete-team-tag",
+    "workScopes": ["TeamworkTag.ReadWrite"],
+    "llmTip": "Permanently delete a tag from a team. This action is irreversible. Use list-team-tags to find the tag ID."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}/members",
+    "method": "get",
+    "toolName": "list-team-tag-members",
+    "workScopes": ["TeamworkTag.Read"],
+    "llmTip": "List all members of a specific tag. Returns member id, displayName, tenantId, and userId. Use list-team-tags to find the tag ID."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}/members/{teamworkTagMember-id}",
+    "method": "delete",
+    "toolName": "remove-team-tag-member",
+    "workScopes": ["TeamworkTag.ReadWrite"],
+    "llmTip": "Remove a member from a tag. Use list-team-tag-members to find the member ID."
+  },
   {
     "pathPattern": "/chats/{chat-id}/messages/{chatMessage-id}/replies",
     "method": "get",

package/dist/generated/client.js

@@ -3559,6 +3559,34 @@ const microsoft_graph_conversationMemberCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_conversationMember)
 }).partial().passthrough();
+const microsoft_graph_teamworkTagType = z.enum(["standard", "unknownFutureValue"]);
+const microsoft_graph_teamworkTagMember = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  displayName: z.string().describe("The member's display name.").nullish(),
+  tenantId: z.string().describe("The ID of the tenant that the tag member is a part of.").nullish(),
+  userId: z.string().describe("The user ID of the member.").nullish()
+}).passthrough();
+const microsoft_graph_teamworkTag = z.object({
+  id: z.string().describe("The unique identifier for an entity. Read-only.").optional(),
+  description: z.string().describe(
+    "The description of the tag as it appears to the user in Microsoft Teams. A teamworkTag can't have more than 200 teamworkTagMembers."
+  ).nullish(),
+  displayName: z.string().describe("The name of the tag as it appears to the user in Microsoft Teams.").nullish(),
+  memberCount: z.number().gte(-2147483648).lte(2147483647).describe("The number of users assigned to the tag.").nullish(),
+  tagType: microsoft_graph_teamworkTagType.optional(),
+  teamId: z.string().describe("ID of the team in which the tag is defined.").nullish(),
+  members: z.array(microsoft_graph_teamworkTagMember).describe("Users assigned to the tag.").optional()
+}).passthrough();
+const microsoft_graph_teamworkTagCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_teamworkTag)
+}).partial().passthrough();
+const microsoft_graph_teamworkTagMemberCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_teamworkTagMember)
+}).partial().passthrough();
 const microsoft_graph_userCollectionResponse = z.object({
   "@odata.count": z.number().int().nullable(),
   "@odata.nextLink": z.string().nullable(),
@@ -3919,6 +3947,11 @@ const schemas = {
   BaseDeltaFunctionResponse,
   microsoft_graph_channelCollectionResponse,
   microsoft_graph_conversationMemberCollectionResponse,
+  microsoft_graph_teamworkTagType,
+  microsoft_graph_teamworkTagMember,
+  microsoft_graph_teamworkTag,
+  microsoft_graph_teamworkTagCollectionResponse,
+  microsoft_graph_teamworkTagMemberCollectionResponse,
   microsoft_graph_userCollectionResponse
 };
 const endpoints = makeApi([
@@ -7924,6 +7957,188 @@ To monitor future changes, call the delta API by using the @odata.deltaLink in t
     ],
     response: z.void()
   },
+  {
+    method: "get",
+    path: "/teams/:teamId/tags",
+    alias: "list-team-tags",
+    description: `Get a list of the tag objects and their properties.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$top",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Show only the first n items").optional()
+      },
+      {
+        name: "$skip",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Skip the first n items").optional()
+      },
+      {
+        name: "$search",
+        type: "Query",
+        schema: z.string().describe("Search items by search phrases").optional()
+      },
+      {
+        name: "$filter",
+        type: "Query",
+        schema: z.string().describe("Filter items by property values").optional()
+      },
+      {
+        name: "$count",
+        type: "Query",
+        schema: z.boolean().describe("Include count of items").optional()
+      },
+      {
+        name: "$orderby",
+        type: "Query",
+        schema: z.array(z.string()).describe("Order items by property values").optional()
+      },
+      {
+        name: "$select",
+        type: "Query",
+        schema: z.array(z.string()).describe("Select properties to be returned").optional()
+      },
+      {
+        name: "$expand",
+        type: "Query",
+        schema: z.array(z.string()).describe("Expand related entities").optional()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "post",
+    path: "/teams/:teamId/tags",
+    alias: "create-team-tag",
+    description: `Create a standard tag for members in a team.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: microsoft_graph_teamworkTag
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "get",
+    path: "/teams/:teamId/tags/:teamworkTagId",
+    alias: "get-team-tag",
+    description: `Read the properties and relationships of a tag object.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$select",
+        type: "Query",
+        schema: z.array(z.string()).describe("Select properties to be returned").optional()
+      },
+      {
+        name: "$expand",
+        type: "Query",
+        schema: z.array(z.string()).describe("Expand related entities").optional()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "patch",
+    path: "/teams/:teamId/tags/:teamworkTagId",
+    alias: "update-team-tag",
+    description: `Update the properties of a tag object.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property values`,
+        type: "Body",
+        schema: microsoft_graph_teamworkTag
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "delete",
+    path: "/teams/:teamId/tags/:teamworkTagId",
+    alias: "delete-team-tag",
+    description: `Delete a tag object permanently.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "If-Match",
+        type: "Header",
+        schema: z.string().describe("ETag").optional()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "get",
+    path: "/teams/:teamId/tags/:teamworkTagId/members",
+    alias: "list-team-tag-members",
+    description: `Get a list of the members of a standard tag in a team and their properties.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "$top",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Show only the first n items").optional()
+      },
+      {
+        name: "$skip",
+        type: "Query",
+        schema: z.number().int().gte(0).describe("Skip the first n items").optional()
+      },
+      {
+        name: "$search",
+        type: "Query",
+        schema: z.string().describe("Search items by search phrases").optional()
+      },
+      {
+        name: "$filter",
+        type: "Query",
+        schema: z.string().describe("Filter items by property values").optional()
+      },
+      {
+        name: "$count",
+        type: "Query",
+        schema: z.boolean().describe("Include count of items").optional()
+      },
+      {
+        name: "$orderby",
+        type: "Query",
+        schema: z.array(z.string()).describe("Order items by property values").optional()
+      },
+      {
+        name: "$select",
+        type: "Query",
+        schema: z.array(z.string()).describe("Select properties to be returned").optional()
+      },
+      {
+        name: "$expand",
+        type: "Query",
+        schema: z.array(z.string()).describe("Expand related entities").optional()
+      }
+    ],
+    response: z.void()
+  },
+  {
+    method: "delete",
+    path: "/teams/:teamId/tags/:teamworkTagId/members/:teamworkTagMemberId",
+    alias: "remove-team-tag-member",
+    description: `Delete a member from a standard tag in a team.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "If-Match",
+        type: "Header",
+        schema: z.string().describe("ETag").optional()
+      }
+    ],
+    response: z.void()
+  },
   {
     method: "get",
     path: "/users",

package/logs/mcp-server.log

@@ -1,10 +1,10 @@
-2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
-2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/messages
-2026-03-25 12:50:25 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/calendar
-2026-03-25 12:50:26 INFO: Using environment variables for secrets
-2026-03-25 12:50:26 INFO: Using environment variables for secrets
-2026-03-25 12:50:26 INFO: Using environment variables for secrets
-2026-03-25 12:50:26 INFO: Using environment variables for secrets
-2026-03-25 12:50:26 INFO: Using environment variables for secrets
+2026-03-25 16:38:47 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-25 16:38:47 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-25 16:38:47 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me
+2026-03-25 16:38:48 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/messages
+2026-03-25 16:38:48 INFO: [GRAPH CLIENT] Final URL being sent to Microsoft: https://graph.microsoft.com/v1.0/me/calendar
+2026-03-25 16:38:49 INFO: Using environment variables for secrets
+2026-03-25 16:38:49 INFO: Using environment variables for secrets
+2026-03-25 16:38:49 INFO: Using environment variables for secrets
+2026-03-25 16:38:49 INFO: Using environment variables for secrets
+2026-03-25 16:38:49 INFO: Using environment variables for secrets

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softeria/ms-365-mcp-server",
-  "version": "0.47.0",
+  "version": "0.47.2",
   "description": " A Model Context Protocol (MCP) server for interacting with Microsoft 365 and Office services through the Graph API",
   "type": "module",
   "main": "dist/index.js",

package/src/endpoints.json

@@ -658,6 +658,55 @@
     "toolName": "list-team-members",
     "workScopes": ["TeamMember.Read.All"]
   },
+  {
+    "pathPattern": "/teams/{team-id}/tags",
+    "method": "get",
+    "toolName": "list-team-tags",
+    "workScopes": ["TeamworkTag.Read"],
+    "llmTip": "List all tags in a team. Returns tag id, displayName, memberCount, and tagType (standard or scheduled). Use list-joined-teams to find the team ID first."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags",
+    "method": "post",
+    "toolName": "create-team-tag",
+    "workScopes": ["TeamworkTag.ReadWrite"],
+    "llmTip": "Create a new tag in a team. Body requires displayName (max 40 chars) and an optional members array (max 25 at creation, each with a userId). Use list-team-members to find user IDs. Add more members individually with add-team-tag-member after creation."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}",
+    "method": "get",
+    "toolName": "get-team-tag",
+    "workScopes": ["TeamworkTag.Read"],
+    "llmTip": "Get details of a specific tag including displayName, memberCount, and tagType. Use list-team-tags to find the tag ID."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}",
+    "method": "patch",
+    "toolName": "update-team-tag",
+    "workScopes": ["TeamworkTag.ReadWrite"],
+    "llmTip": "Update a tag's displayName (max 40 chars). Use list-team-tags to find the tag ID."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}",
+    "method": "delete",
+    "toolName": "delete-team-tag",
+    "workScopes": ["TeamworkTag.ReadWrite"],
+    "llmTip": "Permanently delete a tag from a team. This action is irreversible. Use list-team-tags to find the tag ID."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}/members",
+    "method": "get",
+    "toolName": "list-team-tag-members",
+    "workScopes": ["TeamworkTag.Read"],
+    "llmTip": "List all members of a specific tag. Returns member id, displayName, tenantId, and userId. Use list-team-tags to find the tag ID."
+  },
+  {
+    "pathPattern": "/teams/{team-id}/tags/{teamworkTag-id}/members/{teamworkTagMember-id}",
+    "method": "delete",
+    "toolName": "remove-team-tag-member",
+    "workScopes": ["TeamworkTag.ReadWrite"],
+    "llmTip": "Remove a member from a tag. Use list-team-tag-members to find the member ID."
+  },
   {
     "pathPattern": "/chats/{chat-id}/messages/{chatMessage-id}/replies",
     "method": "get",