@ni-c/imap-mcp 0.2.0

package/dist/tools/write.js

@@ -0,0 +1,291 @@
+import { z } from 'zod';
+import { requestApproval } from '../approval.js';
+import { audit } from '../audit.js';
+import { confirmationPrompt, setResourceKey, } from '../confirm.js';
+import { ToolInputError } from '../errors.js';
+import { withTimeout } from '../imap.js';
+import { buildDraft } from '../draft.js';
+import { jsonResult, run, textResult } from '../result.js';
+import { addressListParam, confirmTokenParam, flagListParam, mailboxParam, optionalMailboxParam, uidListParam, uidParam, } from '../schema.js';
+export function registerWriteTools(server, client, config, confirmations) {
+    server.registerTool('set_message_flags', {
+        title: 'Add or remove message flags',
+        description: 'Adds or removes IMAP flags and keywords on one or more messages: ' +
+            '\\Seen to mark read or unread, \\Flagged to star, \\Answered, \\Draft, ' +
+            'or any custom keyword the server accepts. Reversible, so no ' +
+            'confirmation is required — which is why \\Deleted cannot be added ' +
+            'here; use delete_messages, which asks first. Removing \\Deleted is ' +
+            'allowed, since that undoes one. Removing the new-mail keyword makes ' +
+            'those messages show up in list_new_messages again.',
+        inputSchema: {
+            uids: uidListParam,
+            mailbox: optionalMailboxParam,
+            add: flagListParam.optional().describe('Flags or keywords to set.'),
+            remove: flagListParam
+                .optional()
+                .describe('Flags or keywords to clear.'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false },
+    }, async ({ uids, mailbox, add, remove }) => run(async () => {
+        if (add === undefined && remove === undefined) {
+            throw new ToolInputError('imap-mcp: give at least one of "add" or "remove".');
+        }
+        // \Deleted is not a flag like the others: it is half of a deletion.
+        // This tool has no confirmation and is annotated destructiveHint:false
+        // on the grounds that everything it does can be undone — true of \Seen
+        // and \Flagged, not of a flag that the next client to close the folder,
+        // or any server with autoexpunge, turns into a permanent removal. Left
+        // open it is delete_messages without the dialog, reachable in one call
+        // and present in the `essential` preset.
+        if (add?.some((flag) => flag.toLowerCase() === '\\deleted')) {
+            throw new ToolInputError('imap-mcp: \\Deleted cannot be added here — it marks messages for ' +
+                'permanent removal, which the next client to close the mailbox ' +
+                'may carry out. Use delete_messages, which asks for confirmation. ' +
+                'Moving them to a Trash folder with move_messages is usually what ' +
+                'is meant instead.');
+        }
+        return client.withMailbox(mailbox, false, async (connection) => {
+            if (add !== undefined) {
+                await withTimeout(connection.messageFlagsAdd(uids, add, { uid: true }), 'STORE');
+            }
+            if (remove !== undefined) {
+                await withTimeout(connection.messageFlagsRemove(uids, remove, { uid: true }), 'STORE');
+            }
+            const source = mailbox ?? client.defaultMailbox;
+            audit('set_flags', {
+                mailbox: source,
+                uids,
+                added: add,
+                removed: remove,
+            });
+            return jsonResult({
+                mailbox: source,
+                uids,
+                added: add ?? [],
+                removed: remove ?? [],
+            });
+        });
+    }));
+    server.registerTool('move_messages', {
+        title: 'Move or copy messages',
+        description: 'Moves messages to another mailbox, or copies them when mode is ' +
+            '"copy". Both require confirmation: call once to receive a token, ' +
+            'then again with that token and the same UID list and destination.',
+        inputSchema: {
+            uids: uidListParam,
+            destination: mailboxParam.describe('Mailbox the messages end up in, exactly as listed by list_mailboxes.'),
+            mailbox: optionalMailboxParam,
+            mode: z
+                .enum(['move', 'copy'])
+                .optional()
+                .describe('"move" (default) removes the originals, "copy" keeps them.'),
+            confirm_token: confirmTokenParam,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false },
+    }, async ({ uids, destination, mailbox, mode, confirm_token }) => run(async () => {
+        const copying = mode === 'copy';
+        const source = mailbox ?? client.defaultMailbox;
+        // Copying is confirmed as well. The old rule — a token for "move",
+        // nothing for "copy" — reasoned about deletion, and deletion is not the
+        // only thing that cannot be taken back. `destination` is a free-form
+        // mailbox name, so on a shared account or a public namespace one
+        // unconfirmed call hands every named message to everyone with access to
+        // that folder. Disclosure is the irreversible part, and copying is the
+        // mode that does it while leaving no trace in the source folder.
+        //
+        // The key covers the exact UID set and both mailboxes: a confirmation
+        // for [1] must not execute [1, 2], where the model picked the second
+        // list, and one for Archive must not execute against Public/Shared.
+        const key = setResourceKey(`${copying ? 'copy_messages' : 'move_messages'}:${source}:${destination}`, uids.map(String));
+        if (!confirmations.consume(key, confirm_token)) {
+            return textResult(confirmationPrompt(`${copying ? 'copy' : 'move'} ${uids.length} message(s) between mailboxes`, confirmations.issue(key), confirmations.ttlMinutes, copying
+                ? 'Everyone with access to the destination can read the copies, and taking them back does not unsee them.'
+                : 'The messages keep their content but get new UIDs, so the current ones stop working.', [
+                { label: 'From', value: source },
+                { label: 'To', value: destination },
+            ]));
+        }
+        return client.withMailbox(mailbox, false, async (connection) => {
+            if (copying) {
+                await withTimeout(connection.messageCopy(uids, destination, { uid: true }), 'COPY');
+            }
+            else {
+                await withTimeout(connection.messageMove(uids, destination, { uid: true }), 'MOVE');
+            }
+            audit(copying ? 'copy' : 'move', {
+                from: source,
+                to: destination,
+                uids,
+            });
+            return jsonResult({
+                action: copying ? 'copied' : 'moved',
+                source,
+                destination,
+                uids,
+            });
+        });
+    }));
+    server.registerTool('delete_messages', {
+        title: 'Delete messages',
+        description: 'Permanently deletes messages: sets \\Deleted and expunges them. On ' +
+            'most servers this does not go to Trash — move them there instead if ' +
+            'that is what is meant. Asks the user to confirm; where the client ' +
+            'cannot show a prompt, it falls back to a two-call token.',
+        inputSchema: {
+            uids: uidListParam,
+            mailbox: optionalMailboxParam,
+            confirm_token: confirmTokenParam,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    }, async ({ uids, mailbox, confirm_token }) => run(async () => {
+        const source = mailbox ?? client.defaultMailbox;
+        const approval = await requestApproval(server, confirmations, {
+            what: `Permanently delete ${uids.length} message(s) (UIDs ${uids.slice(0, 20).join(', ')}${uids.length > 20 ? ', …' : ''})`,
+            consequence: 'The messages are expunged, not moved to Trash. They cannot be recovered from here.',
+            resourceKey: setResourceKey(`delete_messages:${source}`, uids.map(String)),
+            token: confirm_token,
+            details: [{ label: 'Mailbox', value: source }],
+        });
+        if (!approval.approved)
+            return approval.result;
+        return client.withMailbox(mailbox, false, async (connection) => {
+            await withTimeout(connection.messageDelete(uids, { uid: true }), 'EXPUNGE');
+            audit('delete', { mailbox: source, uids });
+            return jsonResult({ action: 'deleted', mailbox: source, uids });
+        });
+    }));
+    server.registerTool('manage_mailbox', {
+        title: 'Create, rename or delete a mailbox',
+        description: 'Creates a folder, renames one, or deletes one. Deleting asks the user ' +
+            'to confirm and takes every message in the folder with it; renaming ' +
+            'uses the two-call token because it is reversible.',
+        inputSchema: {
+            action: z
+                .enum(['create', 'rename', 'delete'])
+                .describe('What to do with the mailbox.'),
+            mailbox: mailboxParam.describe('The mailbox to create, rename or delete.'),
+            new_name: mailboxParam
+                .optional()
+                .describe('Required for "rename": the full new path.'),
+            confirm_token: confirmTokenParam,
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true },
+    }, async ({ action, mailbox, new_name, confirm_token }) => run(async () => {
+        if (action === 'rename' && new_name === undefined) {
+            throw new ToolInputError('imap-mcp: "rename" needs new_name — the full new mailbox path.');
+        }
+        if (action === 'delete') {
+            const approval = await requestApproval(server, confirmations, {
+                what: 'Delete a mailbox',
+                consequence: 'Every message in the folder is deleted with it, and it cannot be recovered from here.',
+                resourceKey: `manage_mailbox:delete:${mailbox}`,
+                token: confirm_token,
+                details: [{ label: 'Mailbox', value: mailbox }],
+            });
+            if (!approval.approved)
+                return approval.result;
+        }
+        else if (action === 'rename') {
+            const key = `manage_mailbox:rename:${mailbox}:${new_name ?? ''}`;
+            if (!confirmations.consume(key, confirm_token)) {
+                return textResult(confirmationPrompt('rename a mailbox', confirmations.issue(key), confirmations.ttlMinutes, 'Clients that cached the old path will have to resynchronise.', [
+                    { label: 'Mailbox', value: mailbox },
+                    { label: 'New name', value: new_name ?? '' },
+                ]));
+            }
+        }
+        return client.withConnection(async (connection) => {
+            if (action === 'create') {
+                await withTimeout(connection.mailboxCreate(mailbox), 'CREATE');
+            }
+            else if (action === 'rename') {
+                await withTimeout(connection.mailboxRename(mailbox, new_name), 'RENAME');
+            }
+            else {
+                await withTimeout(connection.mailboxDelete(mailbox), 'DELETE');
+            }
+            audit(`mailbox_${action}`, { mailbox, new_name });
+            return jsonResult({
+                action,
+                mailbox,
+                ...(new_name === undefined ? {} : { new_name }),
+            });
+        });
+    }));
+    server.registerTool('save_draft', {
+        title: 'Save a draft',
+        description: 'Composes a plain-text message and stores it in the Drafts folder. ' +
+            'This server cannot send mail — the draft waits in the mailbox until a ' +
+            'person opens it in their own mail client and sends it from there. ' +
+            'That is deliberate: it keeps the composing useful while leaving the ' +
+            'decision to send with a human.',
+        inputSchema: {
+            to: addressListParam,
+            cc: addressListParam.optional(),
+            bcc: addressListParam.optional(),
+            subject: z
+                .string()
+                .max(500)
+                .refine((v) => !/[\r\n]/.test(v), 'must not contain line breaks')
+                .describe('Subject line.'),
+            body: z
+                .string()
+                .min(1)
+                .max(100_000)
+                .describe('Plain-text body of the message.'),
+            reply_to_uid: uidParam
+                .optional()
+                .describe('UID of the message being answered; threads the draft through In-Reply-To and References.'),
+            mailbox: optionalMailboxParam.describe('Where to look for reply_to_uid. Defaults to the configured mailbox.'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false },
+    }, async ({ to, cc, bcc, subject, body, reply_to_uid, mailbox }) => run(async () => {
+        const thread = reply_to_uid === undefined
+            ? undefined
+            : await client.threadHeaders(mailbox, reply_to_uid);
+        const draft = buildDraft({
+            from: client.user,
+            to,
+            ...(cc === undefined ? {} : { cc }),
+            ...(bcc === undefined ? {} : { bcc }),
+            subject,
+            body,
+            ...(thread === undefined ? {} : { thread }),
+        });
+        const folder = await resolveDraftsMailbox(client, config);
+        await client.withConnection(async (connection) => {
+            await withTimeout(connection.append(folder, draft, ['\\Draft', '\\Seen']), 'APPEND');
+        });
+        audit('save_draft', {
+            mailbox: folder,
+            recipients: to.length + (cc?.length ?? 0) + (bcc?.length ?? 0),
+            in_reply_to: thread?.messageId,
+        });
+        return jsonResult({
+            action: 'draft_saved',
+            mailbox: folder,
+            recipients: [...to, ...(cc ?? []), ...(bcc ?? [])],
+            note: 'The draft is stored but not sent. This server has no way to send mail; open it in your mail client to send it.',
+        });
+    }));
+}
+/**
+ * Finds the Drafts folder.
+ *
+ * The `\Drafts` special-use flag is the right answer where the server reports
+ * it, because folder names are localised — "Entwürfe", "Brouillons" — and
+ * guessing wrong creates a stray folder rather than failing loudly.
+ */
+async function resolveDraftsMailbox(client, config) {
+    if (config.imap.draftsMailbox !== undefined) {
+        return config.imap.draftsMailbox;
+    }
+    const mailboxes = await client.listMailboxes();
+    const found = mailboxes.find((box) => box.specialUse === '\\Drafts');
+    if (found === undefined) {
+        throw new ToolInputError('imap-mcp: this account does not advertise a \\Drafts folder. Call ' +
+            'list_mailboxes to find the right one and set IMAP_DRAFTS_MAILBOX to it.');
+    }
+    return found.path;
+}
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@ni-c/imap-mcp",
+  "version": "0.2.0",
+  "mcpName": "io.github.ni-c/imap-mcp",
+  "description": "MCP server for IMAP mailboxes: read, search, organise and draft mail — it cannot send",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "imap",
+    "email",
+    "mail",
+    "mailbox",
+    "read-only"
+  ],
+  "license": "MIT",
+  "author": "Willi Thiel",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ni-c/imap-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ni-c/imap-mcp/issues"
+  },
+  "homepage": "https://imap-mcp.ni-c.de",
+  "funding": "https://github.com/sponsors/ni-c",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "imap-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "prepublishOnly": "npm run lint && npm run build && npm test",
+    "prebuild": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "lint": "eslint . && prettier --check .",
+    "format": "prettier --write .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "assets": "node scripts/gen-assets.mjs",
+    "assets:check": "node scripts/gen-assets.mjs --check"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "imapflow": "^1.7.6",
+    "mailparser": "^3.9.17",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@resvg/resvg-js": "^2.6.2",
+    "@types/mailparser": "^3.4.6",
+    "@types/node": "^26.4.0",
+    "@vitest/coverage-v8": "4.1.11",
+    "eslint": "^10.9.1",
+    "prettier": "^3.9.6",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.68.0",
+    "vitest": "^4.1.11"
+  }
+}