m365connector 0.3.5 → 0.3.7

package/README.md

@@ -1,30 +1,28 @@
 # m365connector
 
-MCP server that lets AI agents search and read your Microsoft 365 data (emails, files, Teams chats, calendar events, and external connectors).
+MCP server that lets AI agents search and read Microsoft 365 data through a local Edge browser profile and Chrome DevTools Protocol (CDP). No browser extension is required at runtime.
 
-Works with any MCP-compatible client: Claude Code, Claude Desktop, etc.
-
-## How it works
+## How It Works
 
 ```
-MCP Client          m365connector              Browser Extension
-(Claude Code)       (this package)             (Chrome/Edge MV3)
+MCP Client          m365connector              Microsoft Edge
+(Claude Code)       (this package)             (user profile + CDP)
 
-  HTTP :52366         WebSocket :52365
-  ───────────►  ◄──────────────────►
-  Streamable HTTP     IPC bridge              Captures tokens,
-  transport           (localhost)             executes API calls
+  HTTP :52366          CDP :52367
+  ───────────►  ─────────────────►
+  Streamable HTTP     Captures M365 tokens,
+  transport           opens Office/OWA pages
 ```
 
-The MCP server runs as a long-lived process. A companion browser extension connects over WebSocket and handles all M365 API calls using tokens captured from the browser.
+The server starts or connects to Edge with a persistent user profile. It captures Substrate tokens from M365 pages for search. Graph tokens are acquired from Graph Explorer by opening `developer.microsoft.com/en-us/graph/graph-explorer` and, if needed, `tryit.graphexplorer.microsoft.com`, then selecting a valid `https://graph.microsoft.com` access token rendered by the page.
 
 ## Prerequisites
 
 - Node.js 18+
-- The [M365 Connector browser extension](https://github.com/anthropics/m365-connector-extension) loaded in Chrome or Edge
-- An M365 account (work or school)
+- Microsoft Edge
+- An M365 work or school account signed in within the configured Edge profile
 
-## Quick start
+## Quick Start
 
 ```bash
 npx m365connector
@@ -32,12 +30,11 @@ npx m365connector
 
 You should see:
 
-```
-[m365connector/ws] listening on ws://127.0.0.1:52365
+```text
 [m365connector] MCP HTTP listening on http://127.0.0.1:52366/mcp
 ```
 
-Then add to your MCP client config (e.g. `~/.claude/mcp.json`):
+Then add to your MCP client config:
 
 ```json
 {
@@ -50,99 +47,28 @@ Then add to your MCP client config (e.g. `~/.claude/mcp.json`):
 }
 ```
 
-## Global install
-
-```bash
-npm install -g m365connector
-m365connector
-```
-
-## Environment variables
+## Environment Variables
 
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `M365C_MCP_PORT` | 52366 | HTTP port for MCP clients |
-| `M365C_WS_PORT` | 52365 | WebSocket port for extension IPC |
+| `M365C_EDGE_DEBUG_PORT` | 52367 | Edge CDP port |
+| `M365C_EDGE_PATH` | auto-detected | Microsoft Edge executable path |
+| `M365C_EDGE_USER_DATA_DIR` | phantomwright `ud-m365` profile when present, else `~/.m365connector/edge-profile` | Persistent Edge user data directory |
+| `M365C_EDGE_PROFILE_DIRECTORY` | `Default` | Edge profile directory inside the user data dir |
+| `M365C_TOKEN_CACHE_PATH` | `~/.m365connector/token-cache.json` | Local token cache path; stores only current unexpired captured tokens |
 
 ## Tools
 
-### search
-
-Search across M365 data sources.
-
-| Parameter | Type | Required | Default | Description |
-|-----------|------|----------|---------|-------------|
-| query | string | yes | | Search query |
-| conversation_id | string | yes | | Conversation identifier for grouping requests |
-| 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 |
-
-### open
-
-Read the content of a search result.
-
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| read_handle | string | yes | Opaque handle from a search result's `_readHandle` field |
-| conversation_id | string | yes | Conversation identifier |
-
-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.
+- `search`: Search emails, files, Teams chats, calendar events, and external connectors through Substrate.
+- `open`: Read a search result. Office files and protected email can fall back to Edge-driven Office Online or OWA extraction.
+- `whoami`: Read current user profile from Microsoft Graph.
+- `find_people`: Find directory users with Graph filters.
+- `count_people`: Count directory users with Graph filters.
 
 ## Security
 
-- Both servers bind to `127.0.0.1` only (not accessible from the network)
-- WebSocket accepts connections only from `chrome-extension://` origins
-- Read handles are server-issued opaque UUIDs with 30-minute TTL
-
-## License
-
-MIT
+- The MCP server binds to `127.0.0.1`.
+- The Edge CDP port is local-only and uses the configured local user profile.
+- Read handles are server-issued opaque UUIDs with 30-minute TTL.
+- Access tokens are kept in server memory, cached locally with `0600` permissions, and are not printed.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "m365connector",
-  "version": "0.3.5",
-  "description": "MCP server for M365 Connector browser extension",
+  "version": "0.3.7",
+  "description": "MCP server for Microsoft 365 data via Edge CDP",
   "type": "module",
   "main": "src/index.js",
   "bin": {
@@ -12,7 +12,8 @@
     "src"
   ],
   "scripts": {
-    "start": "node src/index.js"
+    "start": "node src/index.js",
+    "test": "node --test"
   },
   "keywords": [
     "mcp",