m365connector 0.3.1 → 0.3.2

package/README.md

@@ -1,6 +1,6 @@
 # m365connector
 
-MCP server that lets AI agents search and read your Microsoft 365 data (emails, files, Teams chats, calendar events, people, and external connectors).
+MCP server that lets AI agents search and read your Microsoft 365 data (emails, files, Teams chats, calendar events, and external connectors).
 
 Works with any MCP-compatible client: Claude Code, Claude Desktop, etc.
 
@@ -74,7 +74,7 @@ Search across M365 data sources.
 |-----------|------|----------|---------|-------------|
 | query | string | yes | | Search query |
 | conversation_id | string | yes | | Conversation identifier for grouping requests |
-| source | string | no | `"all"` | `all`, `email`, `files`, `chat`, `events`, `people`, `external` |
+| source | string | no | `"all"` | `all`, `email`, `files`, `chat`, `events`, `external` |
 | connector | string | no | | External connector name (when source=`external`) |
 | size | integer | no | 10 | Results per page (1--25) |
 | from | integer | no | 0 | Pagination offset |
@@ -90,6 +90,53 @@ Read the content of a search result.
 
 Returns content with a `completeness` field: `full`, `partial`, or `snippet`.
 
+### whoami
+
+Get the current signed-in user's basic profile from Graph.
+When directory scopes are available, response also includes best-effort `manager`, `directReports`, and `directReportsCount` info.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| conversation_id | string | yes | | Conversation identifier |
+| direct_reports_size | integer | no | 30 | Maximum number of direct reports to return (1--100) |
+
+### find_people
+
+Find people via Graph directory query using free-text and structured filters.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| conversation_id | string | yes | | Conversation identifier |
+| query | string | no | | Free-text query matched across person fields |
+| alias | string | no | | Filter by alias (`mailNickname`) |
+| principalName | string | no | | Filter by user principal name |
+| displayName | string | no | | Filter by display name |
+| department | string | no | | Filter by department (prefix match) |
+| office | string | no | | Filter by office location (prefix match) |
+| title | string | no | | Filter by job title (prefix match) |
+| size | integer | no | 20 | Maximum people to return (1--50) |
+| include_direct_reports | boolean | no | false | Include direct reports for each result |
+| direct_reports_size | integer | no | 30 | Maximum direct reports per result (1--100) |
+
+At least one of `query`, `alias`, `principalName`, `displayName`, `department`, `office`, or `title` is required.
+
+### count_people
+
+Count people matching Graph directory filters without returning the full result list.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| conversation_id | string | yes | | Conversation identifier |
+| query | string | no | | Free-text query matched across person fields |
+| alias | string | no | | Filter by alias (`mailNickname`) |
+| principalName | string | no | | Filter by user principal name |
+| displayName | string | no | | Filter by display name |
+| department | string | no | | Filter by department (prefix match) |
+| office | string | no | | Filter by office location (prefix match) |
+| title | string | no | | Filter by job title (prefix match) |
+
+At least one of `query`, `alias`, `principalName`, `displayName`, `department`, `office`, or `title` is required.
+
 ## Security
 
 - Both servers bind to `127.0.0.1` only (not accessible from the network)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "m365connector",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "MCP server for M365 Connector browser extension",
   "type": "module",
   "main": "src/index.js",

package/src/tools/search.js

@@ -1,9 +1,13 @@
 import crypto from "node:crypto";
 
+const WHOAMI_TIMEOUT_MS = 60000;
+const FIND_PEOPLE_TIMEOUT_MS = 90000;
+const COUNT_PEOPLE_TIMEOUT_MS = 120000;
+
 const SEARCH_TOOL = {
   name: "search",
   description:
-    "Search across Microsoft 365 data including emails, files, Teams chats, calendar events, people, and external connectors.",
+    "Search across Microsoft 365 data including emails, files, Teams chats, calendar events, and external connectors.",
   inputSchema: {
     type: "object",
     properties: {
@@ -17,7 +21,7 @@ const SEARCH_TOOL = {
       },
       source: {
         type: "string",
-        enum: ["all", "email", "files", "chat", "events", "people", "external"],
+        enum: ["all", "email", "files", "chat", "events", "external"],
         description: "Data source to search",
         default: "all"
       },
@@ -63,6 +67,135 @@ const OPEN_TOOL = {
   }
 };
 
+const WHOAMI_TOOL = {
+  name: "whoami",
+  description: "Get the current signed-in user's basic profile from Microsoft Graph (/me).",
+  inputSchema: {
+    type: "object",
+    properties: {
+      conversation_id: {
+        type: "string",
+        description: "Client-provided conversation identifier for grouping related requests"
+      },
+      direct_reports_size: {
+        type: "integer",
+        minimum: 1,
+        maximum: 100,
+        description: "Maximum number of direct reports to return",
+        default: 30
+      }
+    },
+    required: ["conversation_id"]
+  }
+};
+
+const FIND_PEOPLE_TOOL = {
+  name: "find_people",
+  description:
+    "Find people from Microsoft Graph directory data using query, alias, principal name, display name, department, office, and title filters.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      conversation_id: {
+        type: "string",
+        description: "Client-provided conversation identifier for grouping related requests"
+      },
+      query: {
+        type: "string",
+        description: "Free-text query matched across person fields"
+      },
+      alias: {
+        type: "string",
+        description: "Filter by alias (mailNickname)"
+      },
+      principalName: {
+        type: "string",
+        description: "Filter by user principal name"
+      },
+      displayName: {
+        type: "string",
+        description: "Filter by display name"
+      },
+      department: {
+        type: "string",
+        description: "Filter by department (prefix match)"
+      },
+      office: {
+        type: "string",
+        description: "Filter by office location (prefix match)"
+      },
+      title: {
+        type: "string",
+        description: "Filter by job title (prefix match)"
+      },
+      size: {
+        type: "integer",
+        minimum: 1,
+        maximum: 50,
+        description: "Maximum number of people to return",
+        default: 20
+      },
+      include_direct_reports: {
+        type: "boolean",
+        description: "Include direct reports for each result",
+        default: false
+      },
+      direct_reports_size: {
+        type: "integer",
+        minimum: 1,
+        maximum: 100,
+        description: "Max direct reports per person",
+        default: 30
+      }
+    },
+    required: ["conversation_id"]
+  }
+};
+
+const COUNT_PEOPLE_TOOL = {
+  name: "count_people",
+  description:
+    "Count people matching filters in Microsoft Graph directory data. Returns only the count, not the full results.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      conversation_id: {
+        type: "string",
+        description: "Client-provided conversation identifier for grouping related requests"
+      },
+      query: {
+        type: "string",
+        description: "Free-text query matched across person fields"
+      },
+      alias: {
+        type: "string",
+        description: "Filter by alias (mailNickname)"
+      },
+      principalName: {
+        type: "string",
+        description: "Filter by user principal name"
+      },
+      displayName: {
+        type: "string",
+        description: "Filter by display name"
+      },
+      department: {
+        type: "string",
+        description: "Filter by department (prefix match)"
+      },
+      office: {
+        type: "string",
+        description: "Filter by office location (prefix match)"
+      },
+      title: {
+        type: "string",
+        description: "Filter by job title (prefix match)"
+      }
+    },
+    required: ["conversation_id"]
+  }
+};
+
 function asObject(value) {
   if (!value || typeof value !== "object") {
     return {};
@@ -201,4 +334,77 @@ export function registerTools(registry, context) {
 
     return asObject(wsResult);
   });
+
+  registry.addTool(WHOAMI_TOOL, async (args) => {
+    const conversationId = String(args.conversation_id || "").trim();
+    if (!conversationId) {
+      throw new Error("conversation_id is required");
+    }
+
+    const wsResult = await context.ws.sendRequest(
+      "whoami",
+      {
+        conversation_id: conversationId,
+        direct_reports_size: Number.isInteger(args.direct_reports_size)
+          ? args.direct_reports_size
+          : 30
+      },
+      { timeoutMs: WHOAMI_TIMEOUT_MS }
+    );
+
+    return asObject(wsResult);
+  });
+
+  registry.addTool(FIND_PEOPLE_TOOL, async (args) => {
+    const conversationId = String(args.conversation_id || "").trim();
+    if (!conversationId) {
+      throw new Error("conversation_id is required");
+    }
+
+    const requestParams = {
+      query: typeof args.query === "string" ? args.query.trim() : "",
+      alias: typeof args.alias === "string" ? args.alias.trim() : "",
+      principalName: typeof args.principalName === "string" ? args.principalName.trim() : "",
+      displayName: typeof args.displayName === "string" ? args.displayName.trim() : "",
+      department: typeof args.department === "string" ? args.department.trim() : "",
+      office: typeof args.office === "string" ? args.office.trim() : "",
+      title: typeof args.title === "string" ? args.title.trim() : "",
+      include_direct_reports: Boolean(args.include_direct_reports),
+      direct_reports_size: Number.isInteger(args.direct_reports_size) ? args.direct_reports_size : 30
+    };
+    const size = Number.isInteger(args.size) ? args.size : 20;
+
+    const wsResult = await context.ws.sendRequest(
+      "find_people",
+      { conversation_id: conversationId, ...requestParams, size },
+      { timeoutMs: FIND_PEOPLE_TIMEOUT_MS }
+    );
+
+    return asObject(wsResult);
+  });
+
+  registry.addTool(COUNT_PEOPLE_TOOL, async (args) => {
+    const conversationId = String(args.conversation_id || "").trim();
+    if (!conversationId) {
+      throw new Error("conversation_id is required");
+    }
+
+    const requestParams = {
+      query: typeof args.query === "string" ? args.query.trim() : "",
+      alias: typeof args.alias === "string" ? args.alias.trim() : "",
+      principalName: typeof args.principalName === "string" ? args.principalName.trim() : "",
+      displayName: typeof args.displayName === "string" ? args.displayName.trim() : "",
+      department: typeof args.department === "string" ? args.department.trim() : "",
+      office: typeof args.office === "string" ? args.office.trim() : "",
+      title: typeof args.title === "string" ? args.title.trim() : ""
+    };
+
+    const wsResult = await context.ws.sendRequest(
+      "count_people",
+      { conversation_id: conversationId, ...requestParams },
+      { timeoutMs: COUNT_PEOPLE_TIMEOUT_MS }
+    );
+
+    return asObject(wsResult);
+  });
 }