@d-mato/gmail-mcp 0.1.6 → 0.1.8

package/README.md

@@ -1,5 +1,7 @@
 # gmail-mcp
 
+[![npm version](https://img.shields.io/npm/v/@d-mato/gmail-mcp.svg)](https://www.npmjs.com/package/@d-mato/gmail-mcp)
+
 MCP server for Gmail — search, read, archive, and manage your email from any MCP client.
 
 ## Setup
@@ -27,6 +29,7 @@ On first launch, a browser window will open for Google account authorization. Af
 |------|-------------|
 | `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_get_thread` | Get all messages in a thread by thread ID |
 | `gmail_archive` | Archive a message (remove from inbox) |
 | `gmail_batch_archive` | Archive multiple messages |
 | `gmail_trash` | Move a message to trash |

package/build/gmail-client.js

@@ -59,6 +59,32 @@ export class GmailClient {
             body,
         };
     }
+    async getThread(threadId) {
+        const res = await this.gmail.users.threads.get({
+            userId: "me",
+            id: threadId,
+            format: "full",
+        });
+        const data = res.data;
+        if (!data.id) {
+            throw new Error(`Invalid thread data for id: ${threadId}`);
+        }
+        const messages = (data.messages ?? []).map((msg) => {
+            if (!msg.id || !msg.threadId) {
+                throw new Error(`Invalid message data in thread: ${threadId}`);
+            }
+            const body = msg.payload ? extractTextBody(msg.payload) : "";
+            return {
+                id: msg.id,
+                threadId: msg.threadId,
+                snippet: msg.snippet ?? "",
+                headers: extractHeaders(msg.payload?.headers),
+                labelIds: msg.labelIds ?? [],
+                body,
+            };
+        });
+        return { id: data.id, messages };
+    }
     async modifyMessage(messageId, addLabelIds = [], removeLabelIds = []) {
         await this.gmail.users.messages.modify({
             userId: "me",

package/build/tools/messages.js

@@ -25,6 +25,12 @@ function formatMessageDetail(msg) {
         msg.body,
     ].join("\n");
 }
+function formatThreadDetail(thread) {
+    const count = thread.messages.length;
+    const header = `Thread: ${thread.id} (${count} ${count === 1 ? "message" : "messages"})`;
+    const body = thread.messages.map(formatMessageDetail).join("\n\n---\n\n");
+    return `${header}\n\n${body}`;
+}
 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"),
@@ -58,6 +64,19 @@ export function registerMessageTools(server, gmail) {
             return wrapGmailError(err, "Message");
         }
     });
+    server.tool("gmail_get_thread", "Get all messages in a Gmail thread by thread ID", {
+        threadId: z.string().describe("Gmail thread ID"),
+    }, async ({ threadId }) => {
+        try {
+            const thread = await gmail.getThread(threadId);
+            return {
+                content: [{ type: "text", text: formatThreadDetail(thread) }],
+            };
+        }
+        catch (err) {
+            return wrapGmailError(err, "Thread");
+        }
+    });
     server.tool("gmail_archive", "Archive a message (remove from inbox)", {
         messageId: z.string().describe("Gmail message ID"),
     }, async ({ messageId }) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d-mato/gmail-mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "MCP server for Gmail - search, read, archive, and manage your email",
   "type": "module",
   "bin": {
@@ -30,10 +30,10 @@
     "zod": "4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.10",
-    "@types/node": "25.5.0",
-    "typescript": "6.0.2",
-    "vitest": "4.1.2"
+    "@biomejs/biome": "2.4.13",
+    "@types/node": "25.6.0",
+    "typescript": "6.0.3",
+    "vitest": "4.1.5"
   },
   "scripts": {
     "build": "tsc",