@honest-magic/mail-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 honest-magic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,178 @@
+# mail-mcp
+
+MCP server for IMAP/SMTP email access — works with Claude and other MCP clients.
+
+## Requirements
+
+- Node.js >=18
+- macOS (credentials stored in Keychain)
+
+## Installation
+
+### Run without installing (recommended)
+
+```bash
+npx @honest-magic/mail-mcp
+```
+
+### Global install
+
+```bash
+npm install -g @honest-magic/mail-mcp
+mail-mcp
+```
+
+## Configuration
+
+### 1. Add an account (interactive)
+
+```bash
+npx @honest-magic/mail-mcp accounts add
+```
+
+This prompts for IMAP/SMTP settings, stores the account in `~/.config/mail-mcp/accounts.json`, and saves the password in macOS Keychain.
+
+### Manage accounts
+
+```bash
+mail-mcp accounts list       # show configured accounts
+mail-mcp accounts remove ID  # remove an account and its keychain entry
+```
+
+### Manual setup
+
+Alternatively, create `~/.config/mail-mcp/accounts.json` by hand:
+
+```json
+[
+  {
+    "id": "work",
+    "name": "Work Email",
+    "host": "imap.example.com",
+    "port": 993,
+    "smtpHost": "smtp.example.com",
+    "smtpPort": 587,
+    "user": "you@example.com",
+    "authType": "login",
+    "useTLS": true
+  }
+]
+```
+
+Then store the password in macOS Keychain:
+
+```bash
+security add-generic-password \
+  -s ch.honest-magic.config.mail-server \
+  -a <account-id> \
+  -w <password-or-app-password>
+```
+
+### Account fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `id` | string | yes | Unique identifier used by MCP tools |
+| `name` | string | yes | Human-readable label |
+| `host` | string | yes | IMAP hostname |
+| `port` | number | yes | IMAP port (993 for TLS, 143 for STARTTLS) |
+| `smtpHost` | string | no | SMTP hostname (omit for read-only use) |
+| `smtpPort` | number | no | SMTP port (587 for STARTTLS, 465 for TLS) |
+| `user` | string | yes | Login username / email address |
+| `authType` | string | yes | `login` or `oauth2` |
+| `useTLS` | boolean | yes | `true` for implicit TLS on IMAP; `false` for STARTTLS |
+
+**OAuth2** — after starting the server, call the `register_oauth2_account` MCP tool:
+
+```json
+{
+  "tool": "register_oauth2_account",
+  "arguments": {
+    "accountId": "work",
+    "clientId": "<oauth2-client-id>",
+    "clientSecret": "<oauth2-client-secret>",
+    "refreshToken": "<oauth2-refresh-token>",
+    "tokenEndpoint": "https://oauth2.googleapis.com/token"
+  }
+}
+```
+
+The credentials are stored in Keychain under the same service name. Token refresh is handled automatically.
+
+### 3. Add to your MCP client
+
+**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "mail": {
+      "command": "npx",
+      "args": ["-y", "@honest-magic/mail-mcp"]
+    }
+  }
+}
+```
+
+**Generic MCP client**:
+
+```json
+{
+  "mcpServers": {
+    "mail": {
+      "command": "mail-mcp"
+    }
+  }
+}
+```
+
+Use `"command": "mail-mcp"` if installed globally, or `"command": "npx", "args": ["-y", "@honest-magic/mail-mcp"]` otherwise.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `list_accounts` | List all configured email accounts |
+| `list_emails` | List recent emails from a folder with metadata and snippets |
+| `search_emails` | Search emails by sender, subject, date range, or keywords |
+| `read_email` | Fetch the full content of an email as Markdown |
+| `send_email` | Send a new email via SMTP |
+| `create_draft` | Save a draft to the Drafts folder without sending |
+| `list_folders` | List all available folders and labels in a mailbox |
+| `move_email` | Move a message to another folder (Archive, Trash, Spam, etc.) |
+| `modify_labels` | Add or remove IMAP flags / provider labels on a message |
+| `get_thread` | Fetch all messages in a conversation thread |
+| `get_attachment` | Download attachment content via MCP Resource URI |
+| `extract_attachment_text` | Extract plain text from PDF and document attachments |
+| `register_oauth2_account` | Store OAuth2 tokens in Keychain for an account |
+| `batch_operations` | Apply move, delete, or label actions to multiple emails at once |
+
+## Read-Only Mode
+
+Start the server with `--read-only` to disable all write operations:
+
+```bash
+npx @honest-magic/mail-mcp --read-only
+```
+
+In read-only mode:
+- Write tools (`send_email`, `create_draft`, `move_email`, `modify_labels`, `batch_operations`, `register_oauth2_account`) are removed from the tool list entirely and return a descriptive error if called directly.
+- SMTP authentication is skipped — only IMAP connects.
+- The active mode is advertised to the MCP client at handshake via `InitializeResult.instructions`.
+
+Claude Desktop read-only config:
+
+```json
+{
+  "mcpServers": {
+    "mail-readonly": {
+      "command": "npx",
+      "args": ["-y", "@honest-magic/mail-mcp", "--read-only"]
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/dist/cli/accounts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Handle `mail-mcp accounts <subcommand>` CLI commands.
+ *
+ * Returns true if a CLI subcommand was handled (caller should process.exit),
+ * false if not a CLI command (caller should start the MCP server).
+ */
+export declare function handleAccountsCommand(args: string[]): Promise<boolean>;

package/dist/cli/accounts.js

@@ -0,0 +1,171 @@
+import { createInterface } from 'node:readline/promises';
+import { getAccounts, saveAccounts, ACCOUNTS_PATH } from '../config.js';
+import { saveCredentials, removeCredentials } from '../security/keychain.js';
+/**
+ * Handle `mail-mcp accounts <subcommand>` CLI commands.
+ *
+ * Returns true if a CLI subcommand was handled (caller should process.exit),
+ * false if not a CLI command (caller should start the MCP server).
+ */
+export async function handleAccountsCommand(args) {
+    if (args[0] !== 'accounts') {
+        return false;
+    }
+    const subcommand = args[1];
+    switch (subcommand) {
+        case 'list':
+            await listAccounts();
+            return true;
+        case 'remove':
+            await removeAccount(args[2]);
+            return true;
+        case 'add':
+            await addAccount();
+            return true;
+        default:
+            console.log('Usage: mail-mcp accounts <add|list|remove>');
+            process.exit(1);
+    }
+}
+async function listAccounts() {
+    const accounts = getAccounts();
+    if (accounts.length === 0) {
+        console.log('No accounts configured.');
+        console.log(`Config file: ${ACCOUNTS_PATH}`);
+        return;
+    }
+    const colWidths = {
+        id: Math.max(2, ...accounts.map((a) => a.id.length)),
+        name: Math.max(4, ...accounts.map((a) => a.name.length)),
+        host: Math.max(4, ...accounts.map((a) => a.host.length)),
+        user: Math.max(4, ...accounts.map((a) => a.user.length)),
+    };
+    const pad = (s, n) => s.padEnd(n);
+    const header = `${pad('ID', colWidths.id)}  ${pad('Name', colWidths.name)}  ${pad('Host', colWidths.host)}  ${pad('User', colWidths.user)}`;
+    const divider = `${'-'.repeat(colWidths.id)}  ${'-'.repeat(colWidths.name)}  ${'-'.repeat(colWidths.host)}  ${'-'.repeat(colWidths.user)}`;
+    console.log(header);
+    console.log(divider);
+    for (const account of accounts) {
+        console.log(`${pad(account.id, colWidths.id)}  ${pad(account.name, colWidths.name)}  ${pad(account.host, colWidths.host)}  ${pad(account.user, colWidths.user)}`);
+    }
+}
+async function removeAccount(id) {
+    if (!id) {
+        console.error('Usage: mail-mcp accounts remove <id>');
+        process.exit(1);
+    }
+    const accounts = getAccounts();
+    const index = accounts.findIndex((a) => a.id === id);
+    if (index === -1) {
+        console.error(`Account '${id}' not found.`);
+        process.exit(1);
+    }
+    accounts.splice(index, 1);
+    saveAccounts(accounts);
+    try {
+        await removeCredentials(id);
+    }
+    catch {
+        console.error(`Warning: could not remove keychain entry for '${id}' (may not exist).`);
+    }
+    console.log(`Account '${id}' removed.`);
+}
+async function addAccount() {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const existingAccounts = getAccounts();
+        const existingIds = new Set(existingAccounts.map((a) => a.id));
+        // id
+        let id = '';
+        while (!id) {
+            const raw = await rl.question('Account ID (required, unique): ');
+            const trimmed = raw.trim();
+            if (!trimmed) {
+                console.log('  ID is required.');
+                continue;
+            }
+            if (existingIds.has(trimmed)) {
+                console.log(`  ID '${trimmed}' already exists. Choose a different ID.`);
+                continue;
+            }
+            id = trimmed;
+        }
+        // name
+        const nameRaw = await rl.question(`Name [${id}]: `);
+        const name = nameRaw.trim() || id;
+        // host (IMAP)
+        let host = '';
+        while (!host) {
+            const raw = await rl.question('IMAP host (e.g. imap.gmail.com): ');
+            const trimmed = raw.trim();
+            if (!trimmed) {
+                console.log('  Host is required.');
+                continue;
+            }
+            host = trimmed;
+        }
+        // port
+        const portRaw = await rl.question('IMAP port [993]: ');
+        const port = parseInt(portRaw.trim(), 10) || 993;
+        // user
+        let user = '';
+        while (!user) {
+            const raw = await rl.question('Email address (user): ');
+            const trimmed = raw.trim();
+            if (!trimmed) {
+                console.log('  Email address is required.');
+                continue;
+            }
+            user = trimmed;
+        }
+        // authType
+        const authTypeRaw = await rl.question('Auth type (login/oauth2) [login]: ');
+        const authType = authTypeRaw.trim() === 'oauth2' ? 'oauth2' : 'login';
+        // useTLS
+        const tlsRaw = await rl.question('Use TLS? (y/n) [y]: ');
+        const useTLS = tlsRaw.trim().toLowerCase() !== 'n';
+        // smtpHost
+        const defaultSmtpHost = host.includes('imap') ? host.replace('imap', 'smtp') : '';
+        const smtpHostRaw = await rl.question(`SMTP host [${defaultSmtpHost || 'press enter to skip'}]: `);
+        const smtpHost = smtpHostRaw.trim() || defaultSmtpHost || undefined;
+        // smtpPort
+        let smtpPort;
+        if (smtpHost) {
+            const smtpPortRaw = await rl.question('SMTP port [587]: ');
+            smtpPort = parseInt(smtpPortRaw.trim(), 10) || 587;
+        }
+        // password (only for login auth)
+        let password;
+        if (authType === 'login') {
+            const passwordRaw = await rl.question('Password (will be stored in macOS Keychain, NOT in config file): ');
+            password = passwordRaw || undefined;
+        }
+        const account = {
+            id,
+            name,
+            host,
+            port,
+            user,
+            authType,
+            useTLS,
+            ...(smtpHost !== undefined ? { smtpHost } : {}),
+            ...(smtpPort !== undefined ? { smtpPort } : {}),
+        };
+        existingAccounts.push(account);
+        saveAccounts(existingAccounts);
+        if (authType === 'login' && password) {
+            await saveCredentials(id, password);
+            console.log(`Account '${id}' added. Password stored in macOS Keychain.`);
+        }
+        else {
+            console.log(`Account '${id}' added.`);
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=accounts.js.map

package/dist/cli/accounts.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+import { EmailAccount } from './types/index.js';
+export declare const ACCOUNTS_PATH: string;
+export declare const config: {
+    serviceName: string;
+    logLevel: string;
+};
+/**
+ * Writes account definitions to ~/.config/mail-mcp/accounts.json.
+ * Creates the directory if it does not exist.
+ */
+export declare function saveAccounts(accounts: EmailAccount[]): void;
+/**
+ * Reads account definitions from ~/.config/mail-mcp/accounts.json.
+ * Returns an empty array if the file does not exist or cannot be parsed.
+ */
+export declare function getAccounts(): EmailAccount[];

package/dist/config.js

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+export const ACCOUNTS_PATH = path.join(os.homedir(), '.config', 'mail-mcp', 'accounts.json');
+const configSchema = z.object({
+    serviceName: z.string().default('ch.honest-magic.config.mail-server'),
+    logLevel: z.string().default('info'),
+});
+export const config = configSchema.parse({
+    serviceName: process.env.SERVICE_NAME,
+    logLevel: process.env.LOG_LEVEL,
+});
+/**
+ * Writes account definitions to ~/.config/mail-mcp/accounts.json.
+ * Creates the directory if it does not exist.
+ */
+export function saveAccounts(accounts) {
+    const configPath = ACCOUNTS_PATH;
+    const dir = path.dirname(configPath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(accounts, null, 2), 'utf-8');
+}
+/**
+ * Reads account definitions from ~/.config/mail-mcp/accounts.json.
+ * Returns an empty array if the file does not exist or cannot be parsed.
+ */
+export function getAccounts() {
+    const configPath = ACCOUNTS_PATH;
+    if (!fs.existsSync(configPath)) {
+        console.error('No accounts config found at ~/.config/mail-mcp/accounts.json');
+        return [];
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed)) {
+            console.error(`Failed to parse accounts config at ${configPath}: expected an array`);
+            return [];
+        }
+        return parsed;
+    }
+    catch (error) {
+        console.error(`Failed to parse accounts config at ${configPath}:`, error);
+        return [];
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAG9B,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;AAE7F,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,oCAAoC,CAAC;IACrE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC;IACvC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;IACrC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;CAChC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAwB;IACnD,MAAM,UAAU,GAAG,aAAa,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvC,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC3E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,UAAU,GAAG,aAAa,CAAC;IAEjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAC9E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,sCAAsC,UAAU,qBAAqB,CAAC,CAAC;YACrF,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,MAAwB,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;QAC1E,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}