npm - outlook-cli - Versions diffs - 1.2.0 - Mend

outlook-cli 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (42) hide show

package/CLI.md +89 -0
package/LICENSE +21 -0
package/QUICKSTART.md +104 -0
package/README.md +994 -0
package/auth/index.js +36 -0
package/auth/oauth-server.js +139 -0
package/auth/token-manager.js +199 -0
package/auth/token-storage.js +282 -0
package/auth/tools.js +127 -0
package/calendar/accept.js +64 -0
package/calendar/cancel.js +64 -0
package/calendar/create.js +69 -0
package/calendar/decline.js +64 -0
package/calendar/delete.js +59 -0
package/calendar/index.js +123 -0
package/calendar/list.js +77 -0
package/cli.js +1349 -0
package/config.js +84 -0
package/docs/PROJECT-STRUCTURE.md +52 -0
package/docs/PUBLISHING.md +86 -0
package/docs/REFERENCE.md +679 -0
package/email/folder-utils.js +171 -0
package/email/index.js +157 -0
package/email/list.js +89 -0
package/email/mark-as-read.js +101 -0
package/email/read.js +128 -0
package/email/search.js +282 -0
package/email/send.js +120 -0
package/folder/create.js +124 -0
package/folder/index.js +78 -0
package/folder/list.js +264 -0
package/folder/move.js +163 -0
package/index.js +136 -0
package/outlook-auth-server.js +305 -0
package/package.json +76 -0
package/rules/create.js +248 -0
package/rules/index.js +177 -0
package/rules/list.js +202 -0
package/tool-registry.js +54 -0
package/utils/graph-api.js +120 -0
package/utils/mock-data.js +145 -0
package/utils/odata-helpers.js +40 -0

package/outlook-auth-server.js ADDED Viewed

@@ -0,0 +1,305 @@
+#!/usr/bin/env node
+const http = require('http');
+const url = require('url');
+const querystring = require('querystring');
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+const config = require('./config');
+// Load environment variables from .env file
+require('dotenv').config();
+// Log to console
+console.log('Starting Outlook Authentication Server');
+// Authentication configuration
+const AUTH_CONFIG = {
+  clientId: config.AUTH_CONFIG.clientId,
+  clientSecret: config.AUTH_CONFIG.clientSecret,
+  redirectUri: config.AUTH_CONFIG.redirectUri,
+  scopes: Array.from(new Set(['offline_access', ...config.AUTH_CONFIG.scopes, 'Contacts.Read'])),
+  tokenStorePath: config.AUTH_CONFIG.tokenStorePath || path.join(process.env.HOME || process.env.USERPROFILE, '.outlook-mcp-tokens.json')
+};
+// Create HTTP server
+const server = http.createServer((req, res) => {
+  const parsedUrl = url.parse(req.url, true);
+  const pathname = parsedUrl.pathname;
+  console.log(`Request received: ${pathname}`);
+  if (pathname === '/auth/callback') {
+    const query = parsedUrl.query;
+    if (query.error) {
+      console.error(`Authentication error: ${query.error} - ${query.error_description}`);
+      res.writeHead(400, { 'Content-Type': 'text/html' });
+      res.end(`
+        <html>
+          <head>
+            <title>Authentication Error</title>
+            <style>
+              body { font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px; }
+              h1 { color: #d9534f; }
+              .error-box { background-color: #f8d7da; border: 1px solid #f5c6cb; padding: 15px; border-radius: 4px; }
+            </style>
+          </head>
+          <body>
+            <h1>Authentication Error</h1>
+            <div class="error-box">
+              <p><strong>Error:</strong> ${query.error}</p>
+              <p><strong>Description:</strong> ${query.error_description || 'No description provided'}</p>
+            </div>
+            <p>Please close this window and try again.</p>
+          </body>
+        </html>
+      `);
+      return;
+    }
+    if (query.code) {
+      console.log('Authorization code received, exchanging for tokens...');
+      // Exchange code for tokens
+      exchangeCodeForTokens(query.code)
+        .then((tokens) => {
+          console.log('Token exchange successful');
+          res.writeHead(200, { 'Content-Type': 'text/html' });
+          res.end(`
+            <html>
+              <head>
+                <title>Authentication Successful</title>
+                <style>
+                  body { font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px; }
+                  h1 { color: #5cb85c; }
+                  .success-box { background-color: #d4edda; border: 1px solid #c3e6cb; padding: 15px; border-radius: 4px; }
+                </style>
+              </head>
+              <body>
+                <h1>Authentication Successful!</h1>
+                <div class="success-box">
+                  <p>You have successfully authenticated with Microsoft Graph API.</p>
+                  <p>The access token has been saved securely.</p>
+                </div>
+                <p>You can now close this window and return to Claude.</p>
+              </body>
+            </html>
+          `);
+        })
+        .catch((error) => {
+          console.error(`Token exchange error: ${error.message}`);
+          res.writeHead(500, { 'Content-Type': 'text/html' });
+          res.end(`
+            <html>
+              <head>
+                <title>Token Exchange Error</title>
+                <style>
+                  body { font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px; }
+                  h1 { color: #d9534f; }
+                  .error-box { background-color: #f8d7da; border: 1px solid #f5c6cb; padding: 15px; border-radius: 4px; }
+                </style>
+              </head>
+              <body>
+                <h1>Token Exchange Error</h1>
+                <div class="error-box">
+                  <p>${error.message}</p>
+                </div>
+                <p>Please close this window and try again.</p>
+              </body>
+            </html>
+          `);
+        });
+    } else {
+      console.error('No authorization code provided');
+      res.writeHead(400, { 'Content-Type': 'text/html' });
+      res.end(`
+        <html>
+          <head>
+            <title>Missing Authorization Code</title>
+            <style>
+              body { font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px; }
+              h1 { color: #d9534f; }
+              .error-box { background-color: #f8d7da; border: 1px solid #f5c6cb; padding: 15px; border-radius: 4px; }
+            </style>
+          </head>
+          <body>
+            <h1>Missing Authorization Code</h1>
+            <div class="error-box">
+              <p>No authorization code was provided in the callback.</p>
+            </div>
+            <p>Please close this window and try again.</p>
+          </body>
+        </html>
+      `);
+    }
+  } else if (pathname === '/auth') {
+    // Handle the /auth route - redirect to Microsoft's OAuth authorization endpoint
+    console.log('Auth request received, redirecting to Microsoft login...');
+    // Verify credentials are set
+    if (!AUTH_CONFIG.clientId || !AUTH_CONFIG.clientSecret) {
+      res.writeHead(500, { 'Content-Type': 'text/html' });
+      res.end(`
+        <html>
+          <head>
+            <title>Configuration Error</title>
+            <style>
+              body { font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto; padding: 20px; }
+              h1 { color: #d9534f; }
+              .error-box { background-color: #f8d7da; border: 1px solid #f5c6cb; padding: 15px; border-radius: 4px; }
+              code { background: #f4f4f4; padding: 2px 4px; border-radius: 4px; }
+            </style>
+          </head>
+          <body>
+            <h1>Configuration Error</h1>
+            <div class="error-box">
+              <p>Microsoft Graph API credentials are not set. Please set the following environment variables:</p>
+              <ul>
+                <li><code>OUTLOOK_CLIENT_ID</code> or <code>MS_CLIENT_ID</code></li>
+                <li><code>OUTLOOK_CLIENT_SECRET</code> or <code>MS_CLIENT_SECRET</code></li>
+              </ul>
+            </div>
+          </body>
+        </html>
+      `);
+      return;
+    }
+    // Get client_id from query parameters or use the default
+    const query = parsedUrl.query;
+    const clientId = query.client_id || AUTH_CONFIG.clientId;
+    // Build the authorization URL
+    const authParams = {
+      client_id: clientId,
+      response_type: 'code',
+      redirect_uri: AUTH_CONFIG.redirectUri,
+      scope: AUTH_CONFIG.scopes.join(' '),
+      response_mode: 'query',
+      state: Date.now().toString() // Simple state parameter for security
+    };
+    const authUrl = `https://login.microsoftonline.com/consumers/oauth2/v2.0/authorize?${querystring.stringify(authParams)}`;
+    console.log(`Redirecting to: ${authUrl}`);
+    // Redirect to Microsoft's login page
+    res.writeHead(302, { 'Location': authUrl });
+    res.end();
+  } else if (pathname === '/') {
+    // Root path - provide instructions
+    res.writeHead(200, { 'Content-Type': 'text/html' });
+    res.end(`
+      <html>
+        <head>
+          <title>Outlook Authentication Server</title>
+          <style>
+            body { font-family: Arial, sans-serif; max-width: 800px; margin: 0 auto; padding: 20px; }
+            h1 { color: #0078d4; }
+            .info-box { background-color: #e7f6fd; border: 1px solid #b3e0ff; padding: 15px; border-radius: 4px; }
+            code { background: #f4f4f4; padding: 2px 4px; border-radius: 4px; }
+          </style>
+        </head>
+        <body>
+          <h1>Outlook Authentication Server</h1>
+          <div class="info-box">
+            <p>This server is running to handle Microsoft Graph API authentication callbacks.</p>
+            <p>Don't navigate here directly. Instead, use the <code>authenticate</code> tool in Claude to start the authentication process.</p>
+            <p>Make sure you've set <code>OUTLOOK_CLIENT_ID</code>/<code>OUTLOOK_CLIENT_SECRET</code> or <code>MS_CLIENT_ID</code>/<code>MS_CLIENT_SECRET</code>.</p>
+          </div>
+          <p>Server is running at http://localhost:3333</p>
+        </body>
+      </html>
+    `);
+  } else {
+    // Not found
+    res.writeHead(404, { 'Content-Type': 'text/plain' });
+    res.end('Not Found');
+  }
+});
+function exchangeCodeForTokens(code) {
+  return new Promise((resolve, reject) => {
+    const postData = querystring.stringify({
+      client_id: AUTH_CONFIG.clientId,
+      client_secret: AUTH_CONFIG.clientSecret,
+      code: code,
+      redirect_uri: AUTH_CONFIG.redirectUri,
+      grant_type: 'authorization_code',
+      scope: AUTH_CONFIG.scopes.join(' ')
+    });
+    const options = {
+      hostname: 'login.microsoftonline.com',
+      path: '/consumers/oauth2/v2.0/token',
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/x-www-form-urlencoded',
+        'Content-Length': Buffer.byteLength(postData)
+      }
+    };
+    const req = https.request(options, (res) => {
+      let data = '';
+      res.on('data', (chunk) => {
+        data += chunk;
+      });
+      res.on('end', () => {
+        if (res.statusCode >= 200 && res.statusCode < 300) {
+          try {
+            const tokenResponse = JSON.parse(data);
+            // Calculate expiration time (current time + expires_in seconds)
+            const expiresAt = Date.now() + (tokenResponse.expires_in * 1000);
+            // Add expires_at for easier expiration checking
+            tokenResponse.expires_at = expiresAt;
+            // Save tokens to file
+            fs.writeFileSync(AUTH_CONFIG.tokenStorePath, JSON.stringify(tokenResponse, null, 2), 'utf8');
+            console.log(`Tokens saved to ${AUTH_CONFIG.tokenStorePath}`);
+            resolve(tokenResponse);
+          } catch (error) {
+            reject(new Error(`Error parsing token response: ${error.message}`));
+          }
+        } else {
+          reject(new Error(`Token exchange failed with status ${res.statusCode}: ${data}`));
+        }
+      });
+    });
+    req.on('error', (error) => {
+      reject(error);
+    });
+    req.write(postData);
+    req.end();
+  });
+}
+// Start server
+const PORT = 3333;
+server.listen(PORT, () => {
+  console.log(`Authentication server running at http://localhost:${PORT}`);
+  console.log(`Waiting for authentication callback at ${AUTH_CONFIG.redirectUri}`);
+  console.log(`Token will be stored at: ${AUTH_CONFIG.tokenStorePath}`);
+  if (!AUTH_CONFIG.clientId || !AUTH_CONFIG.clientSecret) {
+    console.log('\n⚠️  WARNING: Microsoft Graph API credentials are not set.');
+    console.log('   Please set OUTLOOK_CLIENT_ID/OUTLOOK_CLIENT_SECRET or MS_CLIENT_ID/MS_CLIENT_SECRET.');
+  }
+});
+// Handle termination
+process.on('SIGINT', () => {
+  console.log('Authentication server shutting down');
+  process.exit(0);
+});
+process.on('SIGTERM', () => {
+  console.log('Authentication server shutting down');
+  process.exit(0);
+});

package/package.json ADDED Viewed

@@ -0,0 +1,76 @@
+{
+  "name": "outlook-cli",
+  "version": "1.2.0",
+  "description": "Production-ready Outlook CLI with optional MCP server mode powered by Microsoft Graph API",
+  "keywords": [
+    "outlook-cli",
+    "cli",
+    "claude",
+    "outlook",
+    "mcp",
+    "microsoft-graph",
+    "email"
+  ],
+  "homepage": "https://github.com/selvin-paul-raj/outlook-cli#readme",
+  "bugs": {
+    "url": "https://github.com/selvin-paul-raj/outlook-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/selvin-paul-raj/outlook-cli.git"
+  },
+  "license": "MIT",
+  "author": "Selvin PaulRaj K",
+  "type": "commonjs",
+  "main": "index.js",
+  "bin": {
+    "outlook-cli": "cli.js"
+  },
+  "directories": {
+    "doc": "docs",
+    "test": "test"
+  },
+  "files": [
+    "auth",
+    "calendar",
+    "email",
+    "folder",
+    "rules",
+    "utils",
+    "cli.js",
+    "index.js",
+    "tool-registry.js",
+    "config.js",
+    "outlook-auth-server.js",
+    "README.md",
+    "CLI.md",
+    "QUICKSTART.md",
+    "docs",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node cli.js",
+    "mcp-server": "node index.js",
+    "cli": "node cli.js",
+    "doctor": "node cli.js doctor",
+    "auth-server": "node outlook-auth-server.js",
+    "test-mode": "node -e \"process.env.USE_TEST_MODE='true'; require('./index.js');\"",
+    "inspect": "npx @modelcontextprotocol/inspector node index.js",
+    "test": "jest",
+    "prepublishOnly": "npm test && npm pack --dry-run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.1.0",
+    "chalk": "^4.1.2",
+    "dotenv": "^16.5.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.10.2",
+    "jest": "^29.7.0",
+    "supertest": "^7.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "preferGlobal": true
+}

package/rules/create.js ADDED Viewed

@@ -0,0 +1,248 @@
+/**
+ * Create rule functionality
+ */
+const { callGraphAPI } = require('../utils/graph-api');
+const { ensureAuthenticated } = require('../auth');
+const { getFolderIdByName } = require('../email/folder-utils');
+const { getInboxRules } = require('./list');
+/**
+ * Create rule handler
+ * @param {object} args - Tool arguments
+ * @returns {object} - MCP response
+ */
+async function handleCreateRule(args) {
+  const {
+    name,
+    fromAddresses,
+    containsSubject,
+    hasAttachments,
+    moveToFolder,
+    markAsRead,
+    isEnabled = true,
+    sequence
+  } = args;
+  // Add validation for sequence parameter
+  if (sequence !== undefined && (isNaN(sequence) || sequence < 1)) {
+    return {
+      content: [{
+        type: "text",
+        text: "Sequence must be a positive number greater than zero."
+      }]
+    };
+  }
+  if (!name) {
+    return {
+      content: [{
+        type: "text",
+        text: "Rule name is required."
+      }]
+    };
+  }
+  // Validate that at least one condition or action is specified
+  const hasCondition = fromAddresses || containsSubject || hasAttachments === true;
+  const hasAction = moveToFolder || markAsRead === true;
+  if (!hasCondition) {
+    return {
+      content: [{
+        type: "text",
+        text: "At least one condition is required. Specify fromAddresses, containsSubject, or hasAttachments."
+      }]
+    };
+  }
+  if (!hasAction) {
+    return {
+      content: [{
+        type: "text",
+        text: "At least one action is required. Specify moveToFolder or markAsRead."
+      }]
+    };
+  }
+  try {
+    // Get access token
+    const accessToken = await ensureAuthenticated();
+    // Create rule
+    const result = await createInboxRule(accessToken, {
+      name,
+      fromAddresses,
+      containsSubject,
+      hasAttachments,
+      moveToFolder,
+      markAsRead,
+      isEnabled,
+      sequence
+    });
+    let responseText = result.message;
+    // Add a tip about sequence if it wasn't provided
+    if (!sequence && !result.error) {
+      responseText += "\n\nTip: You can specify a 'sequence' parameter when creating rules to control their execution order. Lower sequence numbers run first.";
+    }
+    return {
+      content: [{
+        type: "text",
+        text: responseText
+      }]
+    };
+  } catch (error) {
+    if (error.message === 'Authentication required') {
+      return {
+        content: [{
+          type: "text",
+          text: "Authentication required. Please use the 'authenticate' tool first."
+        }]
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `Error creating rule: ${error.message}`
+      }]
+    };
+  }
+}
+/**
+ * Create a new inbox rule
+ * @param {string} accessToken - Access token
+ * @param {object} ruleOptions - Rule creation options
+ * @returns {Promise<object>} - Result object with status and message
+ */
+async function createInboxRule(accessToken, ruleOptions) {
+  try {
+    const {
+      name,
+      fromAddresses,
+      containsSubject,
+      hasAttachments,
+      moveToFolder,
+      markAsRead,
+      isEnabled,
+      sequence
+    } = ruleOptions;
+    // Get existing rules to determine sequence if not provided
+    let ruleSequence = sequence;
+    if (!ruleSequence) {
+      try {
+        // Default to 100 if we can't get existing rules
+        ruleSequence = 100;
+        // Get existing rules to find highest sequence
+        const existingRules = await getInboxRules(accessToken);
+        if (existingRules && existingRules.length > 0) {
+          // Find the highest sequence
+          const highestSequence = Math.max(...existingRules.map(r => r.sequence || 0));
+          // Set new rule sequence to be higher
+          ruleSequence = Math.max(highestSequence + 1, 100);
+          console.error(`Auto-generated sequence: ${ruleSequence} (based on highest existing: ${highestSequence})`);
+        }
+      } catch (sequenceError) {
+        console.error(`Error determining rule sequence: ${sequenceError.message}`);
+        // Fall back to default value
+        ruleSequence = 100;
+      }
+    }
+    console.error(`Using rule sequence: ${ruleSequence}`);
+    // Make sure sequence is a positive integer
+    ruleSequence = Math.max(1, Math.floor(ruleSequence));
+    // Build rule object with sequence
+    const rule = {
+      displayName: name,
+      isEnabled: isEnabled === true,
+      sequence: ruleSequence,
+      conditions: {},
+      actions: {}
+    };
+    // Add conditions
+    if (fromAddresses) {
+      // Parse email addresses
+      const emailAddresses = fromAddresses.split(',')
+        .map(email => email.trim())
+        .filter(email => email)
+        .map(email => ({
+          emailAddress: {
+            address: email
+          }
+        }));
+      if (emailAddresses.length > 0) {
+        rule.conditions.fromAddresses = emailAddresses;
+      }
+    }
+    if (containsSubject) {
+      rule.conditions.subjectContains = [containsSubject];
+    }
+    if (hasAttachments === true) {
+      rule.conditions.hasAttachment = true;
+    }
+    // Add actions
+    if (moveToFolder) {
+      // Get folder ID
+      try {
+        const folderId = await getFolderIdByName(accessToken, moveToFolder);
+        if (!folderId) {
+          return {
+            success: false,
+            message: `Target folder "${moveToFolder}" not found. Please specify a valid folder name.`
+          };
+        }
+        rule.actions.moveToFolder = folderId;
+      } catch (folderError) {
+        console.error(`Error resolving folder "${moveToFolder}": ${folderError.message}`);
+        return {
+          success: false,
+          message: `Error resolving folder "${moveToFolder}": ${folderError.message}`
+        };
+      }
+    }
+    if (markAsRead === true) {
+      rule.actions.markAsRead = true;
+    }
+    // Create the rule
+    const response = await callGraphAPI(
+      accessToken,
+      'POST',
+      'me/mailFolders/inbox/messageRules',
+      rule
+    );
+    if (response && response.id) {
+      return {
+        success: true,
+        message: `Successfully created rule "${name}" with sequence ${ruleSequence}.`,
+        ruleId: response.id
+      };
+    } else {
+      return {
+        success: false,
+        message: "Failed to create rule. The server didn't return a rule ID."
+      };
+    }
+  } catch (error) {
+    console.error(`Error creating rule: ${error.message}`);
+    throw error;
+  }
+}
+module.exports = handleCreateRule;