@tgai96/outlook-mcp 1.0.1 → 1.1.0

package/README.md

@@ -133,13 +133,23 @@ 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
-DDD
+{
+  "mcpServers": {
+    "outlook": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@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
 
@@ -344,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": {
@@ -374,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/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.1",
+  "version": "1.1.0",
   "description": "MCP server for Claude to access Outlook data via Microsoft Graph API",
   "main": "index.js",
   "bin": {