gmail-mcp-imap 1.0.0

package/build/index.js

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { config } from "dotenv";
+import { GmailClient } from "./gmail-client.js";
+// Load environment variables
+config();
+const GMAIL_EMAIL = process.env.GMAIL_EMAIL;
+const GMAIL_APP_PASSWORD = process.env.GMAIL_APP_PASSWORD;
+if (!GMAIL_EMAIL || !GMAIL_APP_PASSWORD) {
+    console.error("Error: GMAIL_EMAIL and GMAIL_APP_PASSWORD environment variables are required");
+    process.exit(1);
+}
+// Initialize Gmail client
+const gmail = new GmailClient({
+    email: GMAIL_EMAIL,
+    appPassword: GMAIL_APP_PASSWORD,
+});
+// Create MCP server
+const server = new McpServer({
+    name: "gmail-mcp",
+    version: "1.0.0",
+});
+// =============================================================================
+// PRIMARY TOOLS - Gmail Categories (Most Important)
+// =============================================================================
+server.tool("get_primary_emails", "Get emails from Primary category - important conversations from real people", {
+    limit: z.number().min(1).max(50).default(10).describe("Number of emails to fetch"),
+    after: z.string().optional().describe("Filter emails after this date (YYYY/MM/DD or YYYY-MM-DD)"),
+    before: z.string().optional().describe("Filter emails before this date (YYYY/MM/DD or YYYY-MM-DD)"),
+}, async ({ limit, after, before }) => {
+    const emails = await gmail.getEmailsByCategory("primary", limit, { after, before });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(emails, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_social_emails", "Get emails from Social category - notifications from social networks like Facebook, Twitter, LinkedIn", {
+    limit: z.number().min(1).max(50).default(10).describe("Number of emails to fetch"),
+    after: z.string().optional().describe("Filter emails after this date (YYYY/MM/DD or YYYY-MM-DD)"),
+    before: z.string().optional().describe("Filter emails before this date (YYYY/MM/DD or YYYY-MM-DD)"),
+}, async ({ limit, after, before }) => {
+    const emails = await gmail.getEmailsByCategory("social", limit, { after, before });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(emails, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_promotions_emails", "Get emails from Promotions category - marketing emails, deals, offers, newsletters", {
+    limit: z.number().min(1).max(50).default(10).describe("Number of emails to fetch"),
+    after: z.string().optional().describe("Filter emails after this date (YYYY/MM/DD or YYYY-MM-DD)"),
+    before: z.string().optional().describe("Filter emails before this date (YYYY/MM/DD or YYYY-MM-DD)"),
+}, async ({ limit, after, before }) => {
+    const emails = await gmail.getEmailsByCategory("promotions", limit, { after, before });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(emails, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_updates_emails", "Get emails from Updates category - transactional emails like receipts, bills, statements, order confirmations", {
+    limit: z.number().min(1).max(50).default(10).describe("Number of emails to fetch"),
+    after: z.string().optional().describe("Filter emails after this date (YYYY/MM/DD or YYYY-MM-DD)"),
+    before: z.string().optional().describe("Filter emails before this date (YYYY/MM/DD or YYYY-MM-DD)"),
+}, async ({ limit, after, before }) => {
+    const emails = await gmail.getEmailsByCategory("updates", limit, { after, before });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(emails, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_forums_emails", "Get emails from Forums category - mailing lists, discussion groups, online forums", {
+    limit: z.number().min(1).max(50).default(10).describe("Number of emails to fetch"),
+    after: z.string().optional().describe("Filter emails after this date (YYYY/MM/DD or YYYY-MM-DD)"),
+    before: z.string().optional().describe("Filter emails before this date (YYYY/MM/DD or YYYY-MM-DD)"),
+}, async ({ limit, after, before }) => {
+    const emails = await gmail.getEmailsByCategory("forums", limit, { after, before });
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(emails, null, 2),
+            },
+        ],
+    };
+});
+// =============================================================================
+// SECONDARY TOOLS - Search, Read, Send
+// =============================================================================
+server.tool("search_emails", "Search emails using keywords - searches in subject and sender", {
+    query: z.string().describe("Search query (searches subject and sender)"),
+    limit: z.number().min(1).max(50).default(10).describe("Maximum results"),
+}, async ({ query, limit }) => {
+    const emails = await gmail.searchEmails(query, limit);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(emails, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_email_content", "Get full content of a specific email by its UID", {
+    uid: z.number().describe("Email UID (from email list results)"),
+}, async ({ uid }) => {
+    const email = await gmail.getEmailContent(uid);
+    if (!email) {
+        return {
+            content: [{ type: "text", text: "Email not found" }],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(email, null, 2),
+            },
+        ],
+    };
+});
+server.tool("get_emails_by_label", "Get emails from a specific label or folder (e.g., Github, Naukri jobs, Notes)", {
+    label: z.string().describe("Label name (e.g., 'Github', 'Naukri jobs', 'Purchases')"),
+    limit: z.number().min(1).max(50).default(10).describe("Number of emails to fetch"),
+}, async ({ label, limit }) => {
+    const emails = await gmail.getEmailsByLabel(label, limit);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(emails, null, 2),
+            },
+        ],
+    };
+});
+server.tool("list_labels", "List all Gmail labels and folders", {}, async () => {
+    const labels = await gmail.listLabels();
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(labels, null, 2),
+            },
+        ],
+    };
+});
+// =============================================================================
+// ACTION TOOLS - Send, Reply, Manage
+// =============================================================================
+server.tool("send_email", "Send a new email", {
+    to: z.string().describe("Recipient email address"),
+    subject: z.string().describe("Email subject"),
+    body: z.string().describe("Email body content"),
+    cc: z.string().optional().describe("CC recipients (comma-separated)"),
+    bcc: z.string().optional().describe("BCC recipients (comma-separated)"),
+    html: z.boolean().default(false).describe("Send as HTML email"),
+}, async ({ to, subject, body, cc, bcc, html }) => {
+    const result = await gmail.sendEmail(to, subject, body, { cc, bcc, html });
+    return {
+        content: [
+            {
+                type: "text",
+                text: result.success
+                    ? `Email sent successfully! Message ID: ${result.messageId}`
+                    : `Failed to send email: ${result.error}`,
+            },
+        ],
+    };
+});
+server.tool("reply_to_email", "Reply to an existing email", {
+    uid: z.number().describe("UID of the email to reply to"),
+    body: z.string().describe("Reply message body"),
+    html: z.boolean().default(false).describe("Send as HTML"),
+}, async ({ uid, body, html }) => {
+    const result = await gmail.replyEmail(uid, body, { html });
+    return {
+        content: [
+            {
+                type: "text",
+                text: result.success
+                    ? `Reply sent successfully! Message ID: ${result.messageId}`
+                    : `Failed to send reply: ${result.error}`,
+            },
+        ],
+    };
+});
+server.tool("mark_as_read", "Mark an email as read", {
+    uid: z.number().describe("Email UID"),
+}, async ({ uid }) => {
+    const success = await gmail.markAsRead(uid, true);
+    return {
+        content: [
+            {
+                type: "text",
+                text: success ? "Email marked as read" : "Failed to mark email as read",
+            },
+        ],
+    };
+});
+server.tool("mark_as_unread", "Mark an email as unread", {
+    uid: z.number().describe("Email UID"),
+}, async ({ uid }) => {
+    const success = await gmail.markAsRead(uid, false);
+    return {
+        content: [
+            {
+                type: "text",
+                text: success ? "Email marked as unread" : "Failed to mark email as unread",
+            },
+        ],
+    };
+});
+server.tool("star_email", "Star or unstar an email", {
+    uid: z.number().describe("Email UID"),
+    starred: z.boolean().default(true).describe("true to star, false to unstar"),
+}, async ({ uid, starred }) => {
+    const success = await gmail.starEmail(uid, starred);
+    return {
+        content: [
+            {
+                type: "text",
+                text: success
+                    ? `Email ${starred ? "starred" : "unstarred"}`
+                    : "Failed to update star status",
+            },
+        ],
+    };
+});
+server.tool("delete_email", "Move an email to trash", {
+    uid: z.number().describe("Email UID"),
+}, async ({ uid }) => {
+    const success = await gmail.deleteEmail(uid);
+    return {
+        content: [
+            {
+                type: "text",
+                text: success ? "Email moved to trash" : "Failed to delete email",
+            },
+        ],
+    };
+});
+server.tool("apply_label", "Apply a label to an email", {
+    uid: z.number().describe("Email UID"),
+    label: z.string().describe("Label to apply"),
+}, async ({ uid, label }) => {
+    const success = await gmail.applyLabel(uid, label);
+    return {
+        content: [
+            {
+                type: "text",
+                text: success ? `Label "${label}" applied` : "Failed to apply label",
+            },
+        ],
+    };
+});
+// =============================================================================
+// ATTACHMENT TOOLS
+// =============================================================================
+server.tool("download_attachment", "Download an email attachment and return it as Base64 encoded data. Use this to save attachments locally.", {
+    uid: z.number().describe("Email UID"),
+    filename: z.string().describe("Exact filename of the attachment to download"),
+}, async ({ uid, filename }) => {
+    const attachment = await gmail.downloadAttachment(uid, filename);
+    if (!attachment) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Attachment "${filename}" not found in email ${uid}`,
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    filename: attachment.filename,
+                    contentType: attachment.contentType,
+                    size: attachment.size,
+                    content: attachment.content,
+                }, null, 2),
+            },
+        ],
+    };
+});
+server.tool("list_attachments", "List all attachments in an email (without downloading content)", {
+    uid: z.number().describe("Email UID"),
+}, async ({ uid }) => {
+    const attachments = await gmail.listAttachments(uid);
+    return {
+        content: [
+            {
+                type: "text",
+                text: attachments.length > 0
+                    ? JSON.stringify(attachments, null, 2)
+                    : "No attachments found",
+            },
+        ],
+    };
+});
+server.tool("save_attachment", "Download an email attachment and save it to a specified file path", {
+    uid: z.number().describe("Email UID"),
+    filename: z.string().describe("Exact filename of the attachment to download"),
+    savePath: z.string().describe("Full file path where to save the attachment"),
+}, async ({ uid, filename, savePath }) => {
+    const attachment = await gmail.downloadAttachment(uid, filename);
+    if (!attachment) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Attachment "${filename}" not found in email ${uid}`,
+                },
+            ],
+        };
+    }
+    // Save the file
+    const fs = await import("fs/promises");
+    const path = await import("path");
+    try {
+        // Ensure directory exists
+        const dir = path.dirname(savePath);
+        await fs.mkdir(dir, { recursive: true });
+        // Write the file
+        const buffer = Buffer.from(attachment.content, "base64");
+        await fs.writeFile(savePath, buffer);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        savedTo: savePath,
+                        filename: attachment.filename,
+                        contentType: attachment.contentType,
+                        size: attachment.size,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to save attachment: ${error instanceof Error ? error.message : "Unknown error"}`,
+                },
+            ],
+        };
+    }
+});
+// =============================================================================
+// START SERVER
+// =============================================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Gmail MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+// Cleanup on exit
+process.on("SIGINT", async () => {
+    await gmail.disconnect();
+    process.exit(0);
+});
+process.on("SIGTERM", async () => {
+    await gmail.disconnect();
+    process.exit(0);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "gmail-mcp-imap",
+  "version": "1.0.0",
+  "description": "Gmail MCP Server - IMAP/SMTP based email management with Gmail category support and App Password authentication",
+  "main": "build/index.js",
+  "types": "build/index.d.ts",
+  "type": "module",
+  "bin": {
+    "gmail-mcp": "build/index.js"
+  },
+  "files": [
+    "build",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "gmail",
+    "email",
+    "imap",
+    "smtp",
+    "claude",
+    "anthropic",
+    "model-context-protocol",
+    "ai",
+    "automation"
+  ],
+  "author": "Suhail <ansuhail.ak@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/suhailak/gmail-mcp.git"
+  },
+  "homepage": "https://github.com/suhailak/gmail-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/suhailak/gmail-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.24.3",
+    "dotenv": "^17.2.3",
+    "imap": "^0.8.19",
+    "imapflow": "^1.2.0",
+    "mailparser": "^3.9.1",
+    "nodemailer": "^7.0.11",
+    "zod": "^4.2.0"
+  },
+  "devDependencies": {
+    "@types/imap": "^0.8.43",
+    "@types/mailparser": "^3.4.6",
+    "@types/node": "^25.0.2",
+    "@types/nodemailer": "^7.0.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}