@jaingxyz/personal-gmail-mcp 0.1.0

package/dist/tools/mutate.js

@@ -0,0 +1,75 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2026 jaingxyz
+import { z } from "zod";
+import { gmailClient } from "../google.js";
+export const markReadSchema = z.object({
+    messageId: z.string().min(1),
+    isRead: z
+        .boolean()
+        .default(true)
+        .describe("true to mark read (remove UNREAD), false to mark unread."),
+});
+export async function markRead(input) {
+    const gmail = await gmailClient();
+    // Read state in Gmail is the presence/absence of the UNREAD label.
+    await gmail.users.messages.modify({
+        userId: "me",
+        id: input.messageId,
+        requestBody: input.isRead
+            ? { removeLabelIds: ["UNREAD"] }
+            : { addLabelIds: ["UNREAD"] },
+    });
+    return { ok: true, messageId: input.messageId, isRead: input.isRead };
+}
+export const modifyLabelsSchema = z.object({
+    messageId: z.string().min(1),
+    addLabelIds: z
+        .array(z.string())
+        .default([])
+        .describe("Label ids to add (e.g. a custom label id, or STARRED)."),
+    removeLabelIds: z
+        .array(z.string())
+        .default([])
+        .describe("Label ids to remove. Removing INBOX archives the message; adding INBOX un-archives."),
+});
+export async function modifyLabels(input) {
+    const gmail = await gmailClient();
+    const res = await gmail.users.messages.modify({
+        userId: "me",
+        id: input.messageId,
+        requestBody: {
+            addLabelIds: input.addLabelIds,
+            removeLabelIds: input.removeLabelIds,
+        },
+    });
+    return {
+        ok: true,
+        messageId: input.messageId,
+        labelIds: res.data.labelIds ?? [],
+    };
+}
+export const deleteSchema = z.object({
+    messageId: z.string().min(1),
+    hardDelete: z
+        .boolean()
+        .default(false)
+        .describe("false (default): move to Trash (recoverable, auto-purged after ~30 days). true: permanently delete now — not recoverable."),
+});
+export async function deleteMessage(input) {
+    const gmail = await gmailClient();
+    if (input.hardDelete) {
+        await gmail.users.messages.delete({ userId: "me", id: input.messageId });
+        return { ok: true, messageId: input.messageId, mode: "hard" };
+    }
+    await gmail.users.messages.trash({ userId: "me", id: input.messageId });
+    return { ok: true, messageId: input.messageId, mode: "soft" };
+}
+export const untrashSchema = z.object({
+    messageId: z.string().min(1),
+});
+export async function untrash(input) {
+    const gmail = await gmailClient();
+    await gmail.users.messages.untrash({ userId: "me", id: input.messageId });
+    return { ok: true, messageId: input.messageId };
+}
+//# sourceMappingURL=mutate.js.map

package/dist/tools/mutate.js.map

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

package/dist/tools/read.js

@@ -0,0 +1,120 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2026 jaingxyz
+import { z } from "zod";
+import { gmailClient } from "../google.js";
+import { summarizeMessage, extractBody, header, hasAttachments, truncate, } from "./helpers.js";
+const DEFAULT_MAX_BODY_CHARS = 20000;
+export const listLabelsSchema = z.object({});
+export async function listLabels(_input) {
+    const gmail = await gmailClient();
+    const res = await gmail.users.labels.list({ userId: "me" });
+    return {
+        labels: (res.data.labels ?? []).map((l) => ({
+            id: l.id,
+            name: l.name,
+            type: l.type, // "system" | "user"
+            messagesUnread: l.messagesUnread,
+            messagesTotal: l.messagesTotal,
+        })),
+    };
+}
+export const listRecentSchema = z.object({
+    label: z
+        .string()
+        .default("INBOX")
+        .describe("Label id to list. System labels: INBOX, SENT, DRAFT, TRASH, SPAM, STARRED, IMPORTANT, UNREAD. Custom labels use their id (from gmail_list_labels)."),
+    limit: z.number().int().min(1).max(100).default(25),
+    unreadOnly: z.boolean().default(false),
+    cursor: z
+        .string()
+        .optional()
+        .describe("Opaque pagination token from a previous call's nextCursor. When set, returns the next page."),
+});
+export async function listRecent(input) {
+    const gmail = await gmailClient();
+    const labelIds = [input.label];
+    if (input.unreadOnly)
+        labelIds.push("UNREAD");
+    const list = await gmail.users.messages.list({
+        userId: "me",
+        labelIds,
+        maxResults: input.limit,
+        pageToken: input.cursor,
+    });
+    return hydrate(gmail, list.data.messages, list.data.nextPageToken);
+}
+export const searchSchema = z.object({
+    query: z
+        .string()
+        .min(1)
+        .describe("Gmail search query. Supports Gmail operators: from:, to:, subject:, has:attachment, newer_than:7d, label:, is:unread, etc."),
+    limit: z.number().int().min(1).max(100).default(25),
+    cursor: z
+        .string()
+        .optional()
+        .describe("Opaque pagination token from a previous call's nextCursor."),
+});
+export async function search(input) {
+    const gmail = await gmailClient();
+    const list = await gmail.users.messages.list({
+        userId: "me",
+        q: input.query,
+        maxResults: input.limit,
+        pageToken: input.cursor,
+    });
+    return hydrate(gmail, list.data.messages, list.data.nextPageToken);
+}
+// messages.list returns only {id, threadId} stubs. Fetch metadata for each so
+// the caller gets useful summaries (from/subject/date/snippet) in one round.
+async function hydrate(gmail, stubs, nextPageToken) {
+    const ids = (stubs ?? []).map((m) => m.id).filter((id) => !!id);
+    const full = await Promise.all(ids.map((id) => gmail.users.messages
+        .get({
+        userId: "me",
+        id,
+        format: "metadata",
+        metadataHeaders: ["From", "To", "Subject", "Date"],
+    })
+        .then((r) => r.data)));
+    return {
+        messages: full.map(summarizeMessage),
+        nextCursor: nextPageToken ?? null,
+    };
+}
+export const readSchema = z.object({
+    messageId: z.string().min(1),
+    maxBodyChars: z
+        .number()
+        .int()
+        .min(0)
+        .max(1000000)
+        .default(DEFAULT_MAX_BODY_CHARS)
+        .describe("Truncate the body to this many characters (a marker is appended when truncated). 0 disables the cap. Defaults to 20000."),
+});
+export async function read(input) {
+    const gmail = await gmailClient();
+    const res = await gmail.users.messages.get({
+        userId: "me",
+        id: input.messageId,
+        format: "full",
+    });
+    const msg = res.data;
+    const body = extractBody(msg);
+    const { text: content, truncated } = truncate(body.content, input.maxBodyChars ?? DEFAULT_MAX_BODY_CHARS);
+    return {
+        id: msg.id,
+        threadId: msg.threadId,
+        from: header(msg, "From") ?? null,
+        to: header(msg, "To") ?? null,
+        cc: header(msg, "Cc") ?? null,
+        subject: header(msg, "Subject") ?? null,
+        date: header(msg, "Date") ?? null,
+        labelIds: msg.labelIds ?? [],
+        unread: (msg.labelIds ?? []).includes("UNREAD"),
+        hasAttachments: hasAttachments(msg),
+        messageIdHeader: header(msg, "Message-ID") ?? null,
+        references: header(msg, "References") ?? null,
+        body: { contentType: body.contentType, content, truncated },
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/send.js

@@ -0,0 +1,166 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// Copyright (C) 2026 jaingxyz
+import { z } from "zod";
+import { gmailClient } from "../google.js";
+import { buildRawMessage, header } from "./helpers.js";
+const recipientList = z
+    .array(z.string().email())
+    .min(1)
+    .describe("One or more email addresses.");
+const optionalRecipientList = z.array(z.string().email()).default([]);
+const bodyFormat = z
+    .enum(["text", "html"])
+    .default("text")
+    .describe("Body content type: 'text' (plain) or 'html'.");
+export const sendSchema = z.object({
+    to: recipientList,
+    cc: optionalRecipientList,
+    bcc: optionalRecipientList,
+    subject: z.string().default(""),
+    body: z.string().default(""),
+    bodyFormat,
+});
+export async function send(input) {
+    const gmail = await gmailClient();
+    const raw = buildRawMessage({
+        to: input.to,
+        cc: input.cc,
+        bcc: input.bcc,
+        subject: input.subject,
+        body: input.body,
+        bodyFormat: input.bodyFormat,
+    });
+    const res = await gmail.users.messages.send({
+        userId: "me",
+        requestBody: { raw },
+    });
+    return {
+        ok: true,
+        id: res.data.id,
+        threadId: res.data.threadId,
+        to: input.to,
+        subject: input.subject,
+    };
+}
+export const replySchema = z.object({
+    messageId: z.string().min(1).describe("Id of the message being replied to."),
+    body: z.string().min(1).describe("Reply body."),
+    bodyFormat,
+    replyAll: z
+        .boolean()
+        .default(false)
+        .describe("If true, reply to all original recipients (To + Cc)."),
+});
+export async function reply(input) {
+    const gmail = await gmailClient();
+    // Fetch the original to derive recipients + threading headers.
+    const orig = (await gmail.users.messages.get({
+        userId: "me",
+        id: input.messageId,
+        format: "metadata",
+        metadataHeaders: [
+            "From",
+            "To",
+            "Cc",
+            "Subject",
+            "Message-ID",
+            "References",
+        ],
+    })).data;
+    const from = header(orig, "From");
+    const to = from ? [extractEmail(from)] : [];
+    const cc = [];
+    if (input.replyAll) {
+        for (const raw of [header(orig, "To"), header(orig, "Cc")]) {
+            for (const addr of splitAddresses(raw)) {
+                const email = extractEmail(addr);
+                if (email && email !== to[0])
+                    cc.push(email);
+            }
+        }
+    }
+    const origSubject = header(orig, "Subject") ?? "";
+    const subject = /^re:/i.test(origSubject)
+        ? origSubject
+        : `Re: ${origSubject}`;
+    const origMsgId = header(orig, "Message-ID");
+    const origRefs = header(orig, "References");
+    const raw = buildRawMessage({
+        to,
+        cc,
+        subject,
+        body: input.body,
+        bodyFormat: input.bodyFormat,
+        inReplyTo: origMsgId,
+        references: [origRefs, origMsgId].filter(Boolean).join(" ") || undefined,
+    });
+    const res = await gmail.users.messages.send({
+        userId: "me",
+        // threadId keeps the reply in the same conversation.
+        requestBody: { raw, threadId: orig.threadId ?? undefined },
+    });
+    return {
+        ok: true,
+        id: res.data.id,
+        threadId: res.data.threadId,
+        repliedTo: input.messageId,
+        replyAll: input.replyAll,
+    };
+}
+export const createDraftSchema = z.object({
+    to: recipientList,
+    cc: optionalRecipientList,
+    bcc: optionalRecipientList,
+    subject: z.string().default(""),
+    body: z.string().default(""),
+    bodyFormat,
+});
+export async function createDraft(input) {
+    const gmail = await gmailClient();
+    const raw = buildRawMessage({
+        to: input.to,
+        cc: input.cc,
+        bcc: input.bcc,
+        subject: input.subject,
+        body: input.body,
+        bodyFormat: input.bodyFormat,
+    });
+    const res = await gmail.users.drafts.create({
+        userId: "me",
+        requestBody: { message: { raw } },
+    });
+    return { ok: true, draftId: res.data.id, subject: input.subject };
+}
+export const sendDraftSchema = z.object({
+    draftId: z.string().min(1).describe("Id of an existing draft."),
+});
+export async function sendDraft(input) {
+    const gmail = await gmailClient();
+    const res = await gmail.users.drafts.send({
+        userId: "me",
+        requestBody: { id: input.draftId },
+    });
+    return {
+        ok: true,
+        draftId: input.draftId,
+        id: res.data.id,
+        threadId: res.data.threadId,
+    };
+}
+// "Display Name <a@b.com>" -> "a@b.com"; bare "a@b.com" -> "a@b.com".
+export function extractEmail(addr) {
+    const m = addr.match(/<([^>]+)>/);
+    return (m ? m[1] : addr).trim();
+}
+// Split a header value on commas that separate addresses (naive but adequate
+// for reply-all recipient gathering; quoted display names rarely contain commas
+// in practice and a stray cc is harmless).
+export function splitAddresses(raw) {
+    if (!raw)
+        return [];
+    return raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+//# sourceMappingURL=send.js.map

package/dist/tools/send.js.map

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

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@jaingxyz/personal-gmail-mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for a personal Gmail (consumer Google account) inbox and calendar, via the Gmail and Google Calendar APIs. Stdio transport, loopback OAuth, OS-keyring token cache.",
+  "type": "module",
+  "license": "AGPL-3.0-or-later",
+  "author": "jaingxyz",
+  "homepage": "https://github.com/jaingxyz/personal-gmail-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jaingxyz/personal-gmail-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jaingxyz/personal-gmail-mcp/security/advisories/new"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "gmail",
+    "google-calendar",
+    "google-api",
+    "claude",
+    "anthropic"
+  ],
+  "bin": {
+    "personal-gmail-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE",
+    ".env.example"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "whoami": "node dist/scripts/whoami.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepublishOnly": "npm run build && npm run lint && npm run format:check && npm test",
+    "clean": "rm -rf dist coverage"
+  },
+  "engines": {
+    "node": ">=22.22.1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@napi-rs/keyring": "^1.3.0",
+    "googleapis": "^173.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.9.2",
+    "@vitest/coverage-v8": "^4.1.6",
+    "eslint": "^10.4.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "prettier": "^3.8.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.4",
+    "vitest": "^4.1.6"
+  }
+}