@tgai96/outlook-mcp 1.0.0 → 1.1.0

package/README.md

@@ -133,7 +133,7 @@ To use this MCP server with an MCP client, you can either use the published npm
 
 #### Option 1: Using Published npm Package (Recommended)
 
-If the package is published to npm, you can use it directly:
+**To use the current package as-is**, use `@tgai96/outlook-mcp`:
 
 ```json
 {
@@ -142,14 +142,14 @@ If the package is published to npm, you can use it directly:
       "command": "npx",
       "args": [
         "-y",
-        "@yourusername/outlook-mcp"
+        "@tgai96/outlook-mcp"
       ]
     }
   }
 }
 ```
 
-**Note**: The package name is `@tgai96/outlook-mcp` once published.
+**To create and publish your own version**, replace `@tgai96/outlook-mcp` with your own package name and follow the [Publishing to npm](#publishing-to-npm) guide below.
 
 #### Option 2: Using Local Installation
 
@@ -354,29 +354,36 @@ If you see "Access is denied" errors:
 
 ## Publishing to npm
 
-To publish this package to npm:
+To publish this package to npm under your own namespace:
 
-1. **Update package.json metadata** (optional but recommended):
-   - `name` field is already set to `@tgai96/outlook-mcp`
-   - `author` field is set to `tgai96`
+1. **Update package.json metadata**:
+   - Update the `name` field to your desired package name (e.g., `@your-username/outlook-mcp` or `outlook-mcp`)
+   - Update the `author` field with your name/username
    - Optionally add `repository`, `bugs`, and `homepage` fields if you have a GitHub repo
+   - Update the `version` field (following semantic versioning)
 
 2. **Login to npm**:
    ```bash
    npm login
    ```
+   
+   Enter your npm username, password, and email when prompted.
 
-3. **Publish to npm**:
+3. **Verify what will be published** (recommended):
    ```bash
-   npm publish
+   npm pack --dry-run
    ```
    
-   For scoped packages like `@tgai96/outlook-mcp`, use:
+   This shows which files will be included in the package (based on the `files` field in `package.json`).
+
+4. **Publish to npm**:
+
+   For scoped packages (packages starting with `@username/`), use:
    ```bash
    npm publish --access public
    ```
 
-4. **After publishing**, users can use it in their MCP client configuration:
+5. **After publishing**, users can use it in their MCP client configuration:
    ```json
    {
      "mcpServers": {
@@ -384,12 +391,16 @@ To publish this package to npm:
          "command": "npx",
          "args": [
            "-y",
-           "@tgai96/outlook-mcp"
+           "@your-username/outlook-mcp"
          ]
        }
      }
    }
    ```
+   
+   Replace `@your-username/outlook-mcp` with your actual published package name.
+
+**Note**: Make sure to review the `files` field in `package.json` to ensure only necessary files are published (sensitive files, test files, and development scripts should be excluded).
 
 ## License
 

package/auth/tools.js

@@ -3,7 +3,15 @@
  */
 const config = require('../config');
 const tokenManager = require('./token-manager');
-const { ensureAuthenticated, tokenStorage } = require('./index');
+// Lazy load to avoid circular dependency with ./index
+let ensureAuthenticated = null;
+function getEnsureAuthenticated() {
+  if (!ensureAuthenticated) {
+    const authModule = require('./index');
+    ensureAuthenticated = authModule.ensureAuthenticated;
+  }
+  return ensureAuthenticated;
+}
 
 /**
  * About tool handler
@@ -42,7 +50,8 @@ async function handleAuthenticate(args) {
   // If not forcing, try to get a valid token first (will auto-refresh if needed)
   if (!force) {
     try {
-      const accessToken = await ensureAuthenticated();
+      const ensureAuth = getEnsureAuthenticated();
+      const accessToken = await ensureAuth();
       if (accessToken) {
         console.error('[AUTHENTICATE] Successfully obtained valid access token (may have been refreshed)');
         return {

package/cli.js

@@ -216,31 +216,12 @@ if (command === 'config') {
     process.exit(1);
   });
 } else {
-  // Default: Start the MCP server
+  // Default: Start the MCP server directly (not as child process)
   // This is what gets run when npx outlook-mcp is called without arguments
+  // We need to run index.js directly (not spawn) for proper stdio communication with MCP clients
   const mcpServerPath = path.join(__dirname, 'index.js');
-  const child = spawn('node', [mcpServerPath], {
-    stdio: 'inherit',
-    env: process.env
-  });
   
-  // Handle process termination
-  process.on('SIGINT', () => {
-    child.kill('SIGINT');
-    process.exit(0);
-  });
-  
-  process.on('SIGTERM', () => {
-    child.kill('SIGTERM');
-    process.exit(0);
-  });
-  
-  child.on('exit', (code) => {
-    process.exit(code || 0);
-  });
-  
-  child.on('error', (error) => {
-    console.error('Error starting MCP server:', error.message);
-    process.exit(1);
-  });
+  // For MCP server mode, we need direct stdio, so require and run index.js directly
+  // This ensures proper communication with MCP clients
+  require(mcpServerPath);
 }

package/config.js

@@ -51,7 +51,7 @@ const loadedConfig = loadConfig();
 module.exports = {
   // Server information
   SERVER_NAME: "outlook-assistant",
-  SERVER_VERSION: "1.0.0",
+  SERVER_VERSION: "1.1.0",
   
   // Test mode setting
   USE_TEST_MODE: loadedConfig.USE_TEST_MODE,

package/email/date-utils.js

@@ -0,0 +1,21 @@
+/**
+ * Date formatting utilities for email module
+ */
+
+/**
+ * Format date to show both UTC and local time
+ * @param {string} dateTimeString - ISO 8601 date string from API
+ * @returns {string} - Formatted date string with UTC and local time
+ */
+function formatDateTime(dateTimeString) {
+  const date = new Date(dateTimeString);
+  const utcString = date.toUTCString();
+  const localString = date.toLocaleString();
+  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  return `${utcString} (UTC) / ${localString} (${timezone})`;
+}
+
+module.exports = {
+  formatDateTime
+};
+

package/email/list.js

@@ -5,11 +5,12 @@ const config = require('../config');
 const { callGraphAPI, callGraphAPIPaginated } = require('../utils/graph-api');
 const { ensureAuthenticated } = require('../auth');
 const { resolveFolderPath } = require('./folder-utils');
+const { formatDateTime } = require('./date-utils');
 
 /**
  * List emails handler
  * @param {object} args - Tool arguments
- * @returns {object} - MCP response
+ * @returns {Promise<object>} - MCP response
  */
 async function handleListEmails(args) {
   const folder = args.folder || "inbox";
@@ -44,10 +45,10 @@ async function handleListEmails(args) {
     // Format results
     const emailList = response.value.map((email, index) => {
       const sender = email.from ? email.from.emailAddress : { name: 'Unknown', address: 'unknown' };
-      const date = new Date(email.receivedDateTime).toLocaleString();
+      const date = formatDateTime(email.receivedDateTime);
       const readStatus = email.isRead ? '' : '[UNREAD] ';
       
-      return `${index + 1}. ${readStatus}${date} - From: ${sender.name} (${sender.address})\nSubject: ${email.subject}\nID: ${email.id}\n`;
+      return `${index + 1}. ${readStatus}Date: ${date}\nFrom: ${sender.name} (${sender.address})\nSubject: ${email.subject}\nID: ${email.id}\n`;
     }).join("\n");
     
     return {

package/email/read.js

@@ -4,11 +4,12 @@
 const config = require('../config');
 const { callGraphAPI } = require('../utils/graph-api');
 const { ensureAuthenticated } = require('../auth');
+const { formatDateTime } = require('./date-utils');
 
 /**
  * Read email handler
  * @param {object} args - Tool arguments
- * @returns {object} - MCP response
+ * @returns {Promise<object>} - MCP response
  */
 async function handleReadEmail(args) {
   const emailId = args.id;
@@ -51,7 +52,7 @@ async function handleReadEmail(args) {
       const to = email.toRecipients ? email.toRecipients.map(r => `${r.emailAddress.name} (${r.emailAddress.address})`).join(", ") : 'None';
       const cc = email.ccRecipients && email.ccRecipients.length > 0 ? email.ccRecipients.map(r => `${r.emailAddress.name} (${r.emailAddress.address})`).join(", ") : 'None';
       const bcc = email.bccRecipients && email.bccRecipients.length > 0 ? email.bccRecipients.map(r => `${r.emailAddress.name} (${r.emailAddress.address})`).join(", ") : 'None';
-      const date = new Date(email.receivedDateTime).toLocaleString();
+      const date = formatDateTime(email.receivedDateTime);
       
       // Extract body content
       let body = '';

package/email/search.js

@@ -5,11 +5,12 @@ const config = require('../config');
 const { callGraphAPI, callGraphAPIPaginated } = require('../utils/graph-api');
 const { ensureAuthenticated } = require('../auth');
 const { resolveFolderPath } = require('./folder-utils');
+const { formatDateTime } = require('./date-utils');
 
 /**
  * Search emails handler
  * @param {object} args - Tool arguments
- * @returns {object} - MCP response
+ * @returns {Promise<object>} - MCP response
  */
 async function handleSearchEmails(args) {
   const folder = args.folder || "inbox";
@@ -262,10 +263,10 @@ function formatSearchResults(response) {
   // Format results
   const emailList = response.value.map((email, index) => {
     const sender = email.from?.emailAddress || { name: 'Unknown', address: 'unknown' };
-    const date = new Date(email.receivedDateTime).toLocaleString();
+    const date = formatDateTime(email.receivedDateTime);
     const readStatus = email.isRead ? '' : '[UNREAD] ';
     
-    return `${index + 1}. ${readStatus}${date} - From: ${sender.name} (${sender.address})\nSubject: ${email.subject}\nID: ${email.id}\n`;
+    return `${index + 1}. ${readStatus}Date: ${date}\nFrom: ${sender.name} (${sender.address})\nSubject: ${email.subject}\nID: ${email.id}\n`;
   }).join("\n");
   
   // Add search strategy info if available

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tgai96/outlook-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for Claude to access Outlook data via Microsoft Graph API",
   "main": "index.js",
   "bin": {