@d-mato/gmail-mcp 0.1.0

package/README.md

@@ -0,0 +1,50 @@
+# gmail-mcp
+
+MCP server for Gmail — search, read, archive, and manage your email from any MCP client.
+
+## Setup
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "gmail": {
+      "command": "npx",
+      "args": ["-y", "@d-mato/gmail-mcp"]
+    }
+  }
+}
+```
+
+On first launch, a browser window will open for Google account authorization. After granting access, the token is stored locally at `~/.gmail-mcp/tokens.json` and you won't need to authorize again.
+
+## Available Tools
+
+### Messages
+
+| Tool | Description |
+|------|-------------|
+| `gmail_search` | Search messages using Gmail query syntax (e.g. `from:user@example.com`, `is:unread`) |
+| `gmail_get_message` | Get the full content of a message by ID |
+| `gmail_archive` | Archive a message (remove from inbox) |
+| `gmail_batch_archive` | Archive multiple messages |
+| `gmail_trash` | Move a message to trash |
+| `gmail_batch_trash` | Move multiple messages to trash |
+| `gmail_untrash` | Remove a message from trash |
+| `gmail_mark_read` | Mark a message as read |
+| `gmail_mark_unread` | Mark a message as unread |
+
+### Labels
+
+| Tool | Description |
+|------|-------------|
+| `gmail_list_labels` | List all labels |
+| `gmail_add_label` | Add a label to a message |
+| `gmail_remove_label` | Remove a label from a message |
+| `gmail_create_label` | Create a new label |
+| `gmail_delete_label` | Delete a label |
+
+## License
+
+MIT

package/build/auth.d.ts

@@ -0,0 +1,5 @@
+import { google } from "googleapis";
+type OAuth2Client = InstanceType<typeof google.auth.OAuth2>;
+export declare function authenticate(): Promise<OAuth2Client>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/build/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAUpC,KAAK,YAAY,GAAG,YAAY,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAwI5D,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAqC1D"}

package/build/auth.js

@@ -0,0 +1,116 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { createServer } from "node:http";
+import { URL } from "node:url";
+import { google } from "googleapis";
+import open from "open";
+import { CONFIG_DIR, GMAIL_SCOPES, OAUTH_PORT, TOKENS_PATH } from "./types.js";
+// Bundled OAuth client credentials for gmail-mcp.
+// Users can override by setting GMAIL_MCP_CLIENT_ID and GMAIL_MCP_CLIENT_SECRET.
+const DEFAULT_CLIENT_ID = "467574130802-k6hgca5a04vgm05t37vfcqp3ok1bod4l.apps.googleusercontent.com";
+const DEFAULT_CLIENT_SECRET = "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";
+function getCredentials() {
+    const clientId = process.env.GMAIL_MCP_CLIENT_ID ?? DEFAULT_CLIENT_ID;
+    const clientSecret = process.env.GMAIL_MCP_CLIENT_SECRET ?? DEFAULT_CLIENT_SECRET;
+    return { clientId, clientSecret };
+}
+async function loadTokens() {
+    try {
+        const raw = await readFile(TOKENS_PATH, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+async function saveTokens(tokens) {
+    await mkdir(CONFIG_DIR, { recursive: true });
+    await writeFile(TOKENS_PATH, JSON.stringify(tokens, null, 2), {
+        mode: 0o600,
+    });
+}
+function authorizeViaLocalServer(oauth2Client) {
+    return new Promise((resolve, reject) => {
+        const authUrl = oauth2Client.generateAuthUrl({
+            access_type: "offline",
+            prompt: "consent",
+            scope: GMAIL_SCOPES,
+        });
+        const server = createServer(async (req, res) => {
+            try {
+                if (!req.url) {
+                    res.writeHead(400);
+                    res.end("Bad request");
+                    return;
+                }
+                const url = new URL(req.url, `http://localhost:${OAUTH_PORT}`);
+                if (url.pathname !== "/oauth2callback") {
+                    res.writeHead(404);
+                    res.end("Not found");
+                    return;
+                }
+                const code = url.searchParams.get("code");
+                const error = url.searchParams.get("error");
+                if (error) {
+                    res.writeHead(400);
+                    res.end(`Authorization denied: ${error}`);
+                    reject(new Error(`OAuth authorization denied: ${error}`));
+                    server.close();
+                    return;
+                }
+                if (!code) {
+                    res.writeHead(400);
+                    res.end("Missing authorization code");
+                    reject(new Error("Missing authorization code"));
+                    server.close();
+                    return;
+                }
+                const { tokens } = await oauth2Client.getToken(code);
+                oauth2Client.setCredentials(tokens);
+                await saveTokens(tokens);
+                res.writeHead(200, { "Content-Type": "text/html" });
+                res.end("<html><body><h1>Authorization successful!</h1>" +
+                    "<p>You can close this window and return to your terminal.</p></body></html>");
+                server.close();
+                resolve();
+            }
+            catch (err) {
+                res.writeHead(500);
+                res.end("Authorization failed");
+                reject(err);
+                server.close();
+            }
+        });
+        server.listen(OAUTH_PORT, () => {
+            console.error("Opening browser for Gmail authorization...");
+            open(authUrl).catch(() => {
+                console.error(`Please open this URL manually:\n${authUrl}`);
+            });
+        });
+        server.on("error", (err) => {
+            reject(new Error(`Failed to start OAuth server on port ${OAUTH_PORT}: ${err.message}`));
+        });
+    });
+}
+export async function authenticate() {
+    const { clientId, clientSecret } = getCredentials();
+    const oauth2Client = new google.auth.OAuth2(clientId, clientSecret, `http://localhost:${OAUTH_PORT}/oauth2callback`);
+    // Try loading existing tokens
+    const tokens = await loadTokens();
+    if (tokens) {
+        oauth2Client.setCredentials(tokens);
+        // Listen for token refresh events to persist new tokens
+        oauth2Client.on("tokens", (newTokens) => {
+            const merged = { ...tokens, ...newTokens };
+            saveTokens(merged).catch((err) => console.error("Failed to save refreshed tokens:", err));
+        });
+        console.error("Gmail MCP: Using stored credentials");
+        return oauth2Client;
+    }
+    // No tokens — run OAuth flow
+    await authorizeViaLocalServer(oauth2Client);
+    oauth2Client.on("tokens", (newTokens) => {
+        saveTokens(newTokens).catch((err) => console.error("Failed to save refreshed tokens:", err));
+    });
+    console.error("Gmail MCP: Authorization complete");
+    return oauth2Client;
+}

package/build/auth.js.map

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

package/build/gmail-client.d.ts

@@ -0,0 +1,32 @@
+import { type gmail_v1, google } from "googleapis";
+type OAuth2Client = InstanceType<typeof google.auth.OAuth2>;
+interface MessageHeader {
+    from: string;
+    to: string;
+    subject: string;
+    date: string;
+}
+export interface MessageSummary {
+    id: string;
+    threadId: string;
+    snippet: string;
+    headers: MessageHeader;
+    labelIds: string[];
+}
+export interface MessageDetail extends MessageSummary {
+    body: string;
+}
+export declare class GmailClient {
+    private gmail;
+    constructor(auth: OAuth2Client);
+    searchMessages(query: string, maxResults?: number): Promise<MessageSummary[]>;
+    getMessage(messageId: string, format?: "full" | "metadata" | "minimal"): Promise<MessageDetail>;
+    modifyMessage(messageId: string, addLabelIds?: string[], removeLabelIds?: string[]): Promise<void>;
+    trashMessage(messageId: string): Promise<void>;
+    untrashMessage(messageId: string): Promise<void>;
+    listLabels(): Promise<gmail_v1.Schema$Label[]>;
+    createLabel(name: string): Promise<gmail_v1.Schema$Label>;
+    deleteLabel(labelId: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=gmail-client.d.ts.map

package/build/gmail-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmail-client.d.ts","sourceRoot":"","sources":["../src/gmail-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEnD,KAAK,YAAY,GAAG,YAAY,CAAC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAE5D,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,IAAI,EAAE,MAAM,CAAC;CACd;AAwED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAiB;gBAElB,IAAI,EAAE,YAAY;IAIxB,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,cAAc,EAAE,CAAC;IAqCtB,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAM,GAAG,UAAU,GAAG,SAAkB,GAC/C,OAAO,CAAC,aAAa,CAAC;IA0BnB,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,MAAM,EAAO,EAC1B,cAAc,GAAE,MAAM,EAAO,GAC5B,OAAO,CAAC,IAAI,CAAC;IAQV,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO9C,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhD,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IAK9C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;IAQzD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMlD"}

package/build/gmail-client.js

@@ -0,0 +1,158 @@
+import { google } from "googleapis";
+function extractHeaders(headers) {
+    const get = (name) => headers?.find((h) => h.name?.toLowerCase() === name.toLowerCase())?.value ??
+        "";
+    return {
+        from: get("From"),
+        to: get("To"),
+        subject: get("Subject"),
+        date: get("Date"),
+    };
+}
+function decodeBase64Url(data) {
+    return Buffer.from(data, "base64url").toString("utf-8");
+}
+function extractTextBody(payload) {
+    // Direct body
+    if (payload.mimeType === "text/plain" && payload.body?.data) {
+        return decodeBase64Url(payload.body.data);
+    }
+    // Multipart — recurse
+    if (payload.parts) {
+        // Prefer text/plain
+        for (const part of payload.parts) {
+            if (part.mimeType === "text/plain" && part.body?.data) {
+                return decodeBase64Url(part.body.data);
+            }
+        }
+        // Fall back to text/html with tag stripping
+        for (const part of payload.parts) {
+            if (part.mimeType === "text/html" && part.body?.data) {
+                return stripHtml(decodeBase64Url(part.body.data));
+            }
+        }
+        // Recurse into nested multipart
+        for (const part of payload.parts) {
+            const text = extractTextBody(part);
+            if (text)
+                return text;
+        }
+    }
+    // Fallback: HTML body at top level
+    if (payload.mimeType === "text/html" && payload.body?.data) {
+        return stripHtml(decodeBase64Url(payload.body.data));
+    }
+    return "";
+}
+function stripHtml(html) {
+    return html
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+        .replace(/<br\s*\/?>/gi, "\n")
+        .replace(/<\/p>/gi, "\n\n")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+export class GmailClient {
+    gmail;
+    constructor(auth) {
+        this.gmail = google.gmail({ version: "v1", auth });
+    }
+    async searchMessages(query, maxResults = 10) {
+        const res = await this.gmail.users.messages.list({
+            userId: "me",
+            q: query,
+            maxResults: Math.min(maxResults, 50),
+        });
+        const messageIds = res.data.messages ?? [];
+        if (messageIds.length === 0)
+            return [];
+        const messages = await Promise.all(messageIds
+            .filter((m) => m.id != null)
+            .map(async ({ id }) => {
+            const msg = await this.gmail.users.messages.get({
+                userId: "me",
+                id,
+                format: "metadata",
+                metadataHeaders: ["From", "To", "Subject", "Date"],
+            });
+            const data = msg.data;
+            if (!data.id || !data.threadId) {
+                throw new Error(`Invalid message data for id: ${id}`);
+            }
+            return {
+                id: data.id,
+                threadId: data.threadId,
+                snippet: data.snippet ?? "",
+                headers: extractHeaders(data.payload?.headers),
+                labelIds: data.labelIds ?? [],
+            };
+        }));
+        return messages;
+    }
+    async getMessage(messageId, format = "full") {
+        const msg = await this.gmail.users.messages.get({
+            userId: "me",
+            id: messageId,
+            format,
+        });
+        const body = format === "full" && msg.data.payload
+            ? extractTextBody(msg.data.payload)
+            : (msg.data.snippet ?? "");
+        const data = msg.data;
+        if (!data.id || !data.threadId) {
+            throw new Error(`Invalid message data for id: ${messageId}`);
+        }
+        return {
+            id: data.id,
+            threadId: data.threadId,
+            snippet: data.snippet ?? "",
+            headers: extractHeaders(data.payload?.headers),
+            labelIds: data.labelIds ?? [],
+            body,
+        };
+    }
+    async modifyMessage(messageId, addLabelIds = [], removeLabelIds = []) {
+        await this.gmail.users.messages.modify({
+            userId: "me",
+            id: messageId,
+            requestBody: { addLabelIds, removeLabelIds },
+        });
+    }
+    async trashMessage(messageId) {
+        await this.gmail.users.messages.trash({
+            userId: "me",
+            id: messageId,
+        });
+    }
+    async untrashMessage(messageId) {
+        await this.gmail.users.messages.untrash({
+            userId: "me",
+            id: messageId,
+        });
+    }
+    async listLabels() {
+        const res = await this.gmail.users.labels.list({ userId: "me" });
+        return res.data.labels ?? [];
+    }
+    async createLabel(name) {
+        const res = await this.gmail.users.labels.create({
+            userId: "me",
+            requestBody: { name },
+        });
+        return res.data;
+    }
+    async deleteLabel(labelId) {
+        await this.gmail.users.labels.delete({
+            userId: "me",
+            id: labelId,
+        });
+    }
+}

package/build/gmail-client.js.map

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

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { authenticate } from "./auth.js";
+import { GmailClient } from "./gmail-client.js";
+import { registerLabelTools, registerMessageTools } from "./tools/index.js";
+async function main() {
+    const auth = await authenticate();
+    const gmailClient = new GmailClient(auth);
+    const server = new McpServer({
+        name: "gmail-mcp",
+        version: "0.1.0",
+    });
+    registerMessageTools(server, gmailClient);
+    registerLabelTools(server, gmailClient);
+    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);
+});

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,MAAM,YAAY,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC1C,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAExC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;AACrD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/tools/index.d.ts

@@ -0,0 +1,3 @@
+export { registerLabelTools } from "./labels.js";
+export { registerMessageTools } from "./messages.js";
+//# sourceMappingURL=index.d.ts.map

package/build/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/build/tools/index.js

@@ -0,0 +1,2 @@
+export { registerLabelTools } from "./labels.js";
+export { registerMessageTools } from "./messages.js";

package/build/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}

package/build/tools/labels.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GmailClient } from "../gmail-client.js";
+export declare function registerLabelTools(server: McpServer, gmail: GmailClient): void;
+//# sourceMappingURL=labels.d.ts.map

package/build/tools/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/tools/labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAqBtD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,WAAW,GACjB,IAAI,CAqGN"}

package/build/tools/labels.js

@@ -0,0 +1,104 @@
+import { z } from "zod";
+function errorResponse(message) {
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+function wrapGmailError(err) {
+    const error = err;
+    const code = error.code;
+    const msg = error.message ?? String(err);
+    if (code === 404)
+        return errorResponse("Label not found");
+    if (code === 400)
+        return errorResponse(`Invalid request: ${msg}`);
+    if (code === 403)
+        return errorResponse("Insufficient permissions");
+    if (code === 429)
+        return errorResponse("Rate limited — try again later");
+    return errorResponse(msg);
+}
+export function registerLabelTools(server, gmail) {
+    server.tool("gmail_list_labels", "List all Gmail labels", {}, async () => {
+        try {
+            const labels = await gmail.listLabels();
+            const text = labels
+                .map((l) => `${l.id}: ${l.name} (type: ${l.type ?? "user"})`)
+                .join("\n");
+            return { content: [{ type: "text", text: text || "No labels found." }] };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_add_label", "Add a label to a message", {
+        messageId: z.string().describe("Gmail message ID"),
+        labelId: z.string().describe("Label ID to add"),
+    }, async ({ messageId, labelId }) => {
+        try {
+            await gmail.modifyMessage(messageId, [labelId], []);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Label ${labelId} added to message ${messageId}.`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_remove_label", "Remove a label from a message", {
+        messageId: z.string().describe("Gmail message ID"),
+        labelId: z.string().describe("Label ID to remove"),
+    }, async ({ messageId, labelId }) => {
+        try {
+            await gmail.modifyMessage(messageId, [], [labelId]);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Label ${labelId} removed from message ${messageId}.`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_create_label", "Create a new Gmail label", {
+        name: z.string().describe("Label name"),
+    }, async ({ name }) => {
+        try {
+            const label = await gmail.createLabel(name);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Label created: ${label.id} (${label.name})`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_delete_label", "Delete a Gmail label", {
+        labelId: z.string().describe("Label ID to delete"),
+    }, async ({ labelId }) => {
+        try {
+            await gmail.deleteLabel(labelId);
+            return {
+                content: [{ type: "text", text: `Label ${labelId} deleted.` }],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+}

package/build/tools/labels.js.map

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

package/build/tools/messages.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { GmailClient } from "../gmail-client.js";
+export declare function registerMessageTools(server: McpServer, gmail: GmailClient): void;
+//# sourceMappingURL=messages.d.ts.map

package/build/tools/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,oBAAoB,CAAC;AAgD5B,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,WAAW,GACjB,IAAI,CAoLN"}

package/build/tools/messages.js

@@ -0,0 +1,181 @@
+import { z } from "zod";
+function formatMessageSummary(msg) {
+    return [
+        `ID: ${msg.id}`,
+        `Thread: ${msg.threadId}`,
+        `From: ${msg.headers.from}`,
+        `To: ${msg.headers.to}`,
+        `Subject: ${msg.headers.subject}`,
+        `Date: ${msg.headers.date}`,
+        `Labels: ${msg.labelIds.join(", ")}`,
+        `Snippet: ${msg.snippet}`,
+    ].join("\n");
+}
+function formatMessageDetail(msg) {
+    return [
+        `ID: ${msg.id}`,
+        `Thread: ${msg.threadId}`,
+        `From: ${msg.headers.from}`,
+        `To: ${msg.headers.to}`,
+        `Subject: ${msg.headers.subject}`,
+        `Date: ${msg.headers.date}`,
+        `Labels: ${msg.labelIds.join(", ")}`,
+        "",
+        msg.body,
+    ].join("\n");
+}
+function errorResponse(message) {
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+function wrapGmailError(err) {
+    const error = err;
+    const code = error.code;
+    const msg = error.message ?? String(err);
+    if (code === 404)
+        return errorResponse("Message not found");
+    if (code === 400)
+        return errorResponse(`Invalid request: ${msg}`);
+    if (code === 403)
+        return errorResponse("Insufficient permissions");
+    if (code === 429)
+        return errorResponse("Rate limited — try again later");
+    return errorResponse(msg);
+}
+export function registerMessageTools(server, gmail) {
+    server.tool("gmail_search", "Search Gmail messages using Gmail query syntax (e.g. 'from:user@example.com', 'is:unread', 'subject:hello')", {
+        query: z.string().describe("Gmail search query"),
+        maxResults: z
+            .number()
+            .min(1)
+            .max(50)
+            .default(10)
+            .describe("Max results (1-50)"),
+    }, async ({ query, maxResults }) => {
+        try {
+            const messages = await gmail.searchMessages(query, maxResults);
+            if (messages.length === 0) {
+                return { content: [{ type: "text", text: "No messages found." }] };
+            }
+            const text = messages.map(formatMessageSummary).join("\n\n---\n\n");
+            return { content: [{ type: "text", text }] };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_get_message", "Get the full content of a Gmail message by ID", {
+        messageId: z.string().describe("Gmail message ID"),
+    }, async ({ messageId }) => {
+        try {
+            const msg = await gmail.getMessage(messageId, "full");
+            return { content: [{ type: "text", text: formatMessageDetail(msg) }] };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_archive", "Archive a message (remove from inbox)", {
+        messageId: z.string().describe("Gmail message ID"),
+    }, async ({ messageId }) => {
+        try {
+            await gmail.modifyMessage(messageId, [], ["INBOX"]);
+            return {
+                content: [{ type: "text", text: `Message ${messageId} archived.` }],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_batch_archive", "Archive multiple messages", {
+        messageIds: z.array(z.string()).describe("List of Gmail message IDs"),
+    }, async ({ messageIds }) => {
+        try {
+            await Promise.all(messageIds.map((id) => gmail.modifyMessage(id, [], ["INBOX"])));
+            return {
+                content: [
+                    { type: "text", text: `${messageIds.length} messages archived.` },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_trash", "Move a message to trash", {
+        messageId: z.string().describe("Gmail message ID"),
+    }, async ({ messageId }) => {
+        try {
+            await gmail.trashMessage(messageId);
+            return {
+                content: [{ type: "text", text: `Message ${messageId} trashed.` }],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_batch_trash", "Move multiple messages to trash", {
+        messageIds: z.array(z.string()).describe("List of Gmail message IDs"),
+    }, async ({ messageIds }) => {
+        try {
+            await Promise.all(messageIds.map((id) => gmail.trashMessage(id)));
+            return {
+                content: [
+                    { type: "text", text: `${messageIds.length} messages trashed.` },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_untrash", "Remove a message from trash", {
+        messageId: z.string().describe("Gmail message ID"),
+    }, async ({ messageId }) => {
+        try {
+            await gmail.untrashMessage(messageId);
+            return {
+                content: [
+                    { type: "text", text: `Message ${messageId} removed from trash.` },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_mark_read", "Mark a message as read", {
+        messageId: z.string().describe("Gmail message ID"),
+    }, async ({ messageId }) => {
+        try {
+            await gmail.modifyMessage(messageId, [], ["UNREAD"]);
+            return {
+                content: [
+                    { type: "text", text: `Message ${messageId} marked as read.` },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+    server.tool("gmail_mark_unread", "Mark a message as unread", {
+        messageId: z.string().describe("Gmail message ID"),
+    }, async ({ messageId }) => {
+        try {
+            await gmail.modifyMessage(messageId, ["UNREAD"], []);
+            return {
+                content: [
+                    { type: "text", text: `Message ${messageId} marked as unread.` },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err);
+        }
+    });
+}

package/build/tools/messages.js.map

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

package/build/types.d.ts

@@ -0,0 +1,6 @@
+export declare const CONFIG_DIR: string;
+export declare const CREDENTIALS_PATH: string;
+export declare const TOKENS_PATH: string;
+export declare const OAUTH_PORT: number;
+export declare const GMAIL_SCOPES: string[];
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,QAAgC,CAAC;AACxD,eAAO,MAAM,gBAAgB,QAES,CAAC;AACvC,eAAO,MAAM,WAAW,QAC8C,CAAC;AACvE,eAAO,MAAM,UAAU,QAAqD,CAAC;AAE7E,eAAO,MAAM,YAAY,UAIxB,CAAC"}

package/build/types.js

@@ -0,0 +1,10 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export const CONFIG_DIR = join(homedir(), ".gmail-mcp");
+export const TOKENS_PATH = process.env.GMAIL_MCP_TOKENS_PATH ?? join(CONFIG_DIR, "tokens.json");
+export const OAUTH_PORT = Number(process.env.GMAIL_MCP_OAUTH_PORT ?? "3000");
+export const GMAIL_SCOPES = [
+    "https://www.googleapis.com/auth/gmail.readonly",
+    "https://www.googleapis.com/auth/gmail.modify",
+    "https://www.googleapis.com/auth/gmail.labels",
+];

package/build/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,OAAO,CAAC,GAAG,CAAC,0BAA0B;IACtC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GACtB,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,MAAM,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,gDAAgD;IAChD,8CAA8C;IAC9C,8CAA8C;CAC/C,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@d-mato/gmail-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Gmail - search, read, archive, and manage your email",
+  "type": "module",
+  "bin": {
+    "gmail-mcp": "./build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "keywords": [
+    "mcp",
+    "gmail",
+    "email",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/d-mato/gmail-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "googleapis": "^148.0.0",
+    "open": "^10.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.8",
+    "@types/node": "^22.0.0",
+    "typescript": "6.0.0-beta"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write ."
+  }
+}