@softeria/ms-365-mcp-server 0.154.3 → 0.155.0

package/README.md

@@ -105,6 +105,20 @@ Email (Outlook), Calendar, OneDrive Files, Excel, OneNote, To Do Tasks, Planner,
 
 Teams & Chats, Online Meetings, Transcripts & Recordings, Attendance Reports, SharePoint Sites & Lists, Shared Mailboxes & Calendars, User Management, Presence, Virtual Events
 
+Custom Teams emojis are available in organization mode through `list-custom-emojis`
+and `create-custom-emoji` (`teams` and `work` presets). These use the Microsoft Graph
+beta API and request the delegated permissions `TeamworkCustomEmoji.Read` and
+`TeamworkCustomEmoji.Create`, respectively. Read-only mode exposes only the list tool.
+Existing deployments may need consent for these new scopes and reauthentication;
+adding tool support does not upgrade an already-issued token.
+
+Listing returns base64 image content, so use a small `top` and `filter` to keep
+responses manageable. To create an emoji, pass `body: { displayName, contentBytes }`
+with the exact approved name and base64 PNG/GIF file bytes. See Microsoft's
+[list](https://learn.microsoft.com/en-us/graph/api/teamworkmessaging-list-customemojis?view=graph-rest-beta)
+and [create](https://learn.microsoft.com/en-us/graph/api/teamworkmessaging-post-customemojis?view=graph-rest-beta)
+contracts. These tools do not post messages or reactions.
+
 ### Required Graph API Permissions
 
 Permissions are requested dynamically based on which tools are enabled. Use `--list-permissions` to see the exact permissions for your configuration:

package/dist/endpoints.json

@@ -1659,6 +1659,39 @@
     "presets": ["teams", "teams-write", "work"],
     "workScopes": ["Team.ReadBasic.All"]
   },
+  {
+    "pathPattern": "/teamwork/messaging/customEmojis",
+    "method": "get",
+    "toolName": "list-custom-emojis",
+    "apiVersion": "beta",
+    "presets": ["teams", "work"],
+    "workScopes": ["TeamworkCustomEmoji.Read"],
+    "llmTip": "Lists the organization's custom Teams emojis, including displayName, contentBytes (base64 PNG/GIF), createdBy and createdDateTime. The documented query options are $top and $filter. Image bytes can make responses large: start with a small $top and narrow with $filter; use fetchAllPages only for an explicitly requested export. displayName is the unique key, not an id. Work/school accounts only. Microsoft Graph beta API: subject to change."
+  },
+  {
+    "pathPattern": "/teamwork/messaging/customEmojis",
+    "method": "post",
+    "toolName": "create-custom-emoji",
+    "apiVersion": "beta",
+    "presets": ["teams", "work"],
+    "workScopes": ["TeamworkCustomEmoji.Create"],
+    "requestBodySchema": {
+      "type": "object",
+      "required": ["displayName", "contentBytes"],
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Exact unique custom emoji name, without surrounding colons. Must not conflict with an existing emoji name."
+        },
+        "contentBytes": {
+          "type": "string",
+          "description": "Base64-encoded PNG or GIF file content; do not include a data-URL prefix."
+        }
+      },
+      "additionalProperties": false
+    },
+    "llmTip": "Uploads a custom Teams emoji for the organization using body: { displayName, contentBytes }. Only PNG and GIF are supported; pass the complete image file as base64. Confirm the exact name and image with the user before creating it. Returns the created emoji, including its image bytes; use excludeResponse=true when only success/failure is needed. Work/school accounts only. Microsoft Graph beta API: subject to change."
+  },
   {
     "pathPattern": "/teams/{team-id}",
     "method": "get",

package/dist/generated/client-beta.js

@@ -742,6 +742,36 @@ const microsoft_graph_plannerTaskChatMessageCollectionResponse = z.object({
   "@odata.nextLink": z.string().nullable(),
   value: z.array(microsoft_graph_plannerTaskChatMessage)
 }).partial().passthrough();
+const microsoft_graph_customEmojiFromIdentitySet = z.object({
+  application: microsoft_graph_identity.optional(),
+  device: microsoft_graph_identity.optional(),
+  user: microsoft_graph_identity.optional()
+}).passthrough();
+const microsoft_graph_teamworkCustomEmoji = z.object({
+  contentBytes: z.string().describe(
+    "The base64-encoded image content of the emoji. Supported formats include PNG and GIF."
+  ).nullish(),
+  createdBy: microsoft_graph_customEmojiFromIdentitySet.optional(),
+  createdDateTime: z.string().regex(
+    /^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$/
+  ).datetime({ offset: true }).describe(
+    "The date and time when the emoji was created. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2024, is 2024-01-01T00:00:00Z."
+  ).optional(),
+  displayName: z.string().describe(
+    "The unique display name of the custom emoji. Key. Must be unique and must not conflict with existing emoji names."
+  ).optional()
+}).passthrough();
+const microsoft_graph_teamworkCustomEmojiCollectionResponse = z.object({
+  "@odata.count": z.number().int().nullable(),
+  "@odata.nextLink": z.string().nullable(),
+  value: z.array(microsoft_graph_teamworkCustomEmoji)
+}).partial().passthrough();
+const create_custom_emoji_Body = z.object({
+  displayName: z.string().describe(
+    "Exact unique custom emoji name, without surrounding colons. Must not conflict with an existing emoji name."
+  ),
+  contentBytes: z.string().describe("Base64-encoded PNG or GIF file content; do not include a data-URL prefix.")
+}).passthrough();
 const schemas = {
   microsoft_graph_allowedAudiences,
   microsoft_graph_identity,
@@ -800,7 +830,11 @@ const schemas = {
   microsoft_graph_plannerTaskChatReactionEvent,
   microsoft_graph_plannerTaskChatReaction,
   microsoft_graph_plannerTaskChatMessage,
-  microsoft_graph_plannerTaskChatMessageCollectionResponse
+  microsoft_graph_plannerTaskChatMessageCollectionResponse,
+  microsoft_graph_customEmojiFromIdentitySet,
+  microsoft_graph_teamworkCustomEmoji,
+  microsoft_graph_teamworkCustomEmojiCollectionResponse,
+  create_custom_emoji_Body
 };
 const endpoints = makeApi([
   {
@@ -903,6 +937,72 @@ const endpoints = makeApi([
       }
     ],
     response: z.void()
+  },
+  {
+    method: "get",
+    path: "/teamwork/messaging/customEmojis",
+    alias: "list-custom-emojis",
+    description: `Get a list of custom emojis available in the teamwork messaging of the organization.`,
+    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: microsoft_graph_teamworkCustomEmojiCollectionResponse
+  },
+  {
+    method: "post",
+    path: "/teamwork/messaging/customEmojis",
+    alias: "create-custom-emoji",
+    description: `Create a new custom emoji in the teamwork messaging of the organization, which adds the custom emoji to Teams for the tenant. The emoji image is provided as base64-encoded content bytes.`,
+    requestFormat: "json",
+    parameters: [
+      {
+        name: "body",
+        description: `New navigation property`,
+        type: "Body",
+        schema: create_custom_emoji_Body
+      }
+    ],
+    response: microsoft_graph_teamworkCustomEmoji
   }
 ]);
 const api = new Zodios(endpoints);

package/dist/graph-tools.js

@@ -1671,7 +1671,7 @@ function registerGraphTools(server, graphClient, readOnly = false, enabledToolsP
     }
     if (isFetchAllPagesApplicable(tool)) {
       const maxPages = getMaxPages();
-      paramSchema["fetchAllPages"] = z.boolean().describe(getFetchAllPagesParamDescription(maxPages)).optional();
+      paramSchema["fetchAllPages"] = z.boolean().describe(getFetchAllPagesParamDescription(maxPages, tool.alias)).optional();
     }
     if (isSkiptokenApplicable(tool, Object.keys(paramSchema))) {
       paramSchema["skiptoken"] = z.string().describe(SKIPTOKEN_PARAM_DESCRIPTION).optional();

package/dist/lib/param-descriptions.js

@@ -55,8 +55,9 @@ function getAccountParamDescription(accountNames) {
   const accountHint = accountNames.length > 0 ? `Known accounts: ${accountNames.join(", ")}. ` : "";
   return `${accountHint}Microsoft account email to use for this request. Required when multiple accounts are configured. Use the list-accounts tool to discover all currently available accounts.`;
 }
-function getFetchAllPagesParamDescription(maxPages) {
-  return `Follow @odata.nextLink and merge up to ${maxPages} pages into one response. Can return enormous payloads\u2014only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with $filter/$search.`;
+function getFetchAllPagesParamDescription(maxPages, toolAlias) {
+  const narrowingOptions = toolAlias === "list-custom-emojis" ? "$filter" : "$filter/$search";
+  return `Follow @odata.nextLink and merge up to ${maxPages} pages into one response. Can return enormous payloads\u2014only when the user explicitly needs a full export. Prefer a small $top first, then paginate or narrow with ${narrowingOptions}.`;
 }
 function getODataParamDescription(bareName) {
   switch (bareName) {

package/dist/lib/query-parameter-schema.js

@@ -1,9 +1,16 @@
 import { z } from "zod";
 import { getODataParamDescription, shouldOmitTopParam } from "./param-descriptions.js";
 const TEAM_LIST_TOOLS = /* @__PURE__ */ new Set(["list-joined-teams", "list-my-associated-teams"]);
+const CUSTOM_EMOJI_QUERY_DESCRIPTIONS = {
+  top: "Number of custom emojis to return in one page. Each emoji includes base64 image content; use a small page size to keep the response manageable.",
+  filter: "OData filter expression for custom emojis, forwarded to Microsoft Graph. Filter support is determined by the beta API."
+};
 function queryParameterSchema(toolName, name, providerSchema) {
   const bareName = name.replace(/^\$/, "").toLowerCase();
   if (TEAM_LIST_TOOLS.has(toolName)) return void 0;
+  if (toolName === "list-custom-emojis" && !["top", "filter", "skiptoken"].includes(bareName)) {
+    return void 0;
+  }
   if (bareName === "top" && shouldOmitTopParam(toolName)) return void 0;
   const source = providerSchema instanceof z.ZodOptional ? providerSchema.unwrap() : providerSchema;
   let schema = source;
@@ -25,7 +32,7 @@ function queryParameterSchema(toolName, name, providerSchema) {
       break;
   }
   if (providerSchema.isOptional()) schema = schema.optional();
-  const description = getODataParamDescription(bareName);
+  const description = toolName === "list-custom-emojis" && CUSTOM_EMOJI_QUERY_DESCRIPTIONS[bareName] || getODataParamDescription(bareName);
   return description ? schema.describe(description) : schema;
 }
 export {

package/dist/lib/tool-schema.js

@@ -53,7 +53,7 @@ function describeToolSchema(tool, config, ctx = {}) {
       name: "fetchAllPages",
       in: "Query",
       required: false,
-      description: getFetchAllPagesParamDescription(getMaxPages()),
+      description: getFetchAllPagesParamDescription(getMaxPages(), tool.alias),
       schema: { type: "boolean" }
     });
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@softeria/ms-365-mcp-server",
   "mcpName": "io.github.Softeria/ms-365-mcp-server",
-  "version": "0.154.3",
+  "version": "0.155.0",
   "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

@@ -1659,6 +1659,39 @@
     "presets": ["teams", "teams-write", "work"],
     "workScopes": ["Team.ReadBasic.All"]
   },
+  {
+    "pathPattern": "/teamwork/messaging/customEmojis",
+    "method": "get",
+    "toolName": "list-custom-emojis",
+    "apiVersion": "beta",
+    "presets": ["teams", "work"],
+    "workScopes": ["TeamworkCustomEmoji.Read"],
+    "llmTip": "Lists the organization's custom Teams emojis, including displayName, contentBytes (base64 PNG/GIF), createdBy and createdDateTime. The documented query options are $top and $filter. Image bytes can make responses large: start with a small $top and narrow with $filter; use fetchAllPages only for an explicitly requested export. displayName is the unique key, not an id. Work/school accounts only. Microsoft Graph beta API: subject to change."
+  },
+  {
+    "pathPattern": "/teamwork/messaging/customEmojis",
+    "method": "post",
+    "toolName": "create-custom-emoji",
+    "apiVersion": "beta",
+    "presets": ["teams", "work"],
+    "workScopes": ["TeamworkCustomEmoji.Create"],
+    "requestBodySchema": {
+      "type": "object",
+      "required": ["displayName", "contentBytes"],
+      "properties": {
+        "displayName": {
+          "type": "string",
+          "description": "Exact unique custom emoji name, without surrounding colons. Must not conflict with an existing emoji name."
+        },
+        "contentBytes": {
+          "type": "string",
+          "description": "Base64-encoded PNG or GIF file content; do not include a data-URL prefix."
+        }
+      },
+      "additionalProperties": false
+    },
+    "llmTip": "Uploads a custom Teams emoji for the organization using body: { displayName, contentBytes }. Only PNG and GIF are supported; pass the complete image file as base64. Confirm the exact name and image with the user before creating it. Returns the created emoji, including its image bytes; use excludeResponse=true when only success/failure is needed. Work/school accounts only. Microsoft Graph beta API: subject to change."
+  },
   {
     "pathPattern": "/teams/{team-id}",
     "method": "get",