@lengelhard/imap-email-mcp 1.0.5 → 1.1.0

package/index.js

@@ -365,6 +365,75 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           },
           required: ['uid']
         }
+      },
+      {
+        name: 'move_email',
+        description: 'Move an email from one folder to another (e.g. Inbox → Action, Waiting, Delegated, Hold)',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            uid: {
+              type: 'number',
+              description: 'Email UID to move'
+            },
+            from_folder: {
+              type: 'string',
+              description: 'Source folder name (default: INBOX)',
+              default: 'INBOX'
+            },
+            to_folder: {
+              type: 'string',
+              description: 'Destination folder name (e.g. Action, Waiting, Delegated, Hold, Archive)'
+            }
+          },
+          required: ['uid', 'to_folder']
+        }
+      },
+      {
+        name: 'flag_email',
+        description: 'Add or remove the \\Flagged flag on an email (star/unstar). Used to manage the /Flagged urgency overlay.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            uid: {
+              type: 'number',
+              description: 'Email UID'
+            },
+            folder: {
+              type: 'string',
+              description: 'Folder containing the email (default: INBOX)',
+              default: 'INBOX'
+            },
+            flagged: {
+              type: 'boolean',
+              description: 'true to add the flag (star), false to remove it (unstar)'
+            }
+          },
+          required: ['uid', 'flagged']
+        }
+      },
+      {
+        name: 'mark_seen',
+        description: 'Mark an email as read (seen) or unread (unseen). Used to signal triage state via the \\Seen flag.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            uid: {
+              type: 'number',
+              description: 'Email UID'
+            },
+            folder: {
+              type: 'string',
+              description: 'Folder containing the email (default: INBOX)',
+              default: 'INBOX'
+            },
+            seen: {
+              type: 'boolean',
+              description: 'true to mark as read, false to mark as unread'
+            }
+          },
+          required: ['uid', 'seen']
+        }
       }
     ]
   };
@@ -846,6 +915,97 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
       }
 
+      case 'move_email': {
+        const fromFolder = args.from_folder || 'INBOX';
+        const toFolder = args.to_folder;
+        const connection = await connectIMAP();
+
+        try {
+          await connection.openBox(fromFolder);
+
+          // node-imap exposes move() on the underlying imap object.
+          // We wrap it in a Promise so it fits the async/await flow.
+          await new Promise((resolve, reject) => {
+            connection.imap.move(args.uid, toFolder, (err) => {
+              if (err) reject(err);
+              else resolve();
+            });
+          });
+
+          return {
+            content: [{
+              type: 'text',
+              text: JSON.stringify({
+                success: true,
+                uid: args.uid,
+                from: fromFolder,
+                to: toFolder
+              }, null, 2)
+            }]
+          };
+        } finally {
+          connection.end();
+        }
+      }
+
+      case 'flag_email': {
+        const folder = args.folder || 'INBOX';
+        const connection = await connectIMAP();
+
+        try {
+          await connection.openBox(folder);
+
+          if (args.flagged) {
+            await connection.addFlags(args.uid, ['\\Flagged']);
+          } else {
+            await connection.delFlags(args.uid, ['\\Flagged']);
+          }
+
+          return {
+            content: [{
+              type: 'text',
+              text: JSON.stringify({
+                success: true,
+                uid: args.uid,
+                folder,
+                flagged: args.flagged
+              }, null, 2)
+            }]
+          };
+        } finally {
+          connection.end();
+        }
+      }
+
+      case 'mark_seen': {
+        const folder = args.folder || 'INBOX';
+        const connection = await connectIMAP();
+
+        try {
+          await connection.openBox(folder);
+
+          if (args.seen) {
+            await connection.addFlags(args.uid, ['\\Seen']);
+          } else {
+            await connection.delFlags(args.uid, ['\\Seen']);
+          }
+
+          return {
+            content: [{
+              type: 'text',
+              text: JSON.stringify({
+                success: true,
+                uid: args.uid,
+                folder,
+                seen: args.seen
+              }, null, 2)
+            }]
+          };
+        } finally {
+          connection.end();
+        }
+      }
+
       default:
         return { content: [{ type: 'text', text: `Unknown tool: ${name}` }] };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lengelhard/imap-email-mcp",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "MCP server for Claude Code that provides email capabilities through IMAP/SMTP. Read, search, compose, and manage emails from any IMAP provider.",
   "type": "module",
   "main": "index.js",