@mcp-z/mcp-gmail 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +167 -0
- package/bin/server.js +5 -0
- package/dist/cjs/constants.d.cts +11 -0
- package/dist/cjs/constants.d.ts +11 -0
- package/dist/cjs/constants.js +39 -0
- package/dist/cjs/constants.js.map +1 -0
- package/dist/cjs/email/composition/rfc822-builder.d.cts +11 -0
- package/dist/cjs/email/composition/rfc822-builder.d.ts +11 -0
- package/dist/cjs/email/composition/rfc822-builder.js +24 -0
- package/dist/cjs/email/composition/rfc822-builder.js.map +1 -0
- package/dist/cjs/email/messages/fetch-message.d.cts +24 -0
- package/dist/cjs/email/messages/fetch-message.d.ts +24 -0
- package/dist/cjs/email/messages/fetch-message.js +367 -0
- package/dist/cjs/email/messages/fetch-message.js.map +1 -0
- package/dist/cjs/email/messages/messages.d.cts +7 -0
- package/dist/cjs/email/messages/messages.d.ts +7 -0
- package/dist/cjs/email/messages/messages.js +146 -0
- package/dist/cjs/email/messages/messages.js.map +1 -0
- package/dist/cjs/email/parsing/header-parsing.d.cts +1 -0
- package/dist/cjs/email/parsing/header-parsing.d.ts +1 -0
- package/dist/cjs/email/parsing/header-parsing.js +20 -0
- package/dist/cjs/email/parsing/header-parsing.js.map +1 -0
- package/dist/cjs/email/parsing/headers-utils.d.cts +5 -0
- package/dist/cjs/email/parsing/headers-utils.d.ts +5 -0
- package/dist/cjs/email/parsing/headers-utils.js +46 -0
- package/dist/cjs/email/parsing/headers-utils.js.map +1 -0
- package/dist/cjs/email/parsing/html-processing.d.cts +8 -0
- package/dist/cjs/email/parsing/html-processing.d.ts +8 -0
- package/dist/cjs/email/parsing/html-processing.js +72 -0
- package/dist/cjs/email/parsing/html-processing.js.map +1 -0
- package/dist/cjs/email/parsing/message-extraction.d.cts +2 -0
- package/dist/cjs/email/parsing/message-extraction.d.ts +2 -0
- package/dist/cjs/email/parsing/message-extraction.js +25 -0
- package/dist/cjs/email/parsing/message-extraction.js.map +1 -0
- package/dist/cjs/email/querying/execute-query.d.cts +17 -0
- package/dist/cjs/email/querying/execute-query.d.ts +17 -0
- package/dist/cjs/email/querying/execute-query.js +265 -0
- package/dist/cjs/email/querying/execute-query.js.map +1 -0
- package/dist/cjs/email/querying/pagination.d.cts +27 -0
- package/dist/cjs/email/querying/pagination.d.ts +27 -0
- package/dist/cjs/email/querying/pagination.js +533 -0
- package/dist/cjs/email/querying/pagination.js.map +1 -0
- package/dist/cjs/email/querying/query-builder.d.cts +47 -0
- package/dist/cjs/email/querying/query-builder.d.ts +47 -0
- package/dist/cjs/email/querying/query-builder.js +387 -0
- package/dist/cjs/email/querying/query-builder.js.map +1 -0
- package/dist/cjs/email/querying/search-execution.d.cts +29 -0
- package/dist/cjs/email/querying/search-execution.d.ts +29 -0
- package/dist/cjs/email/querying/search-execution.js +190 -0
- package/dist/cjs/email/querying/search-execution.js.map +1 -0
- package/dist/cjs/index.d.cts +8 -0
- package/dist/cjs/index.d.ts +8 -0
- package/dist/cjs/index.js +314 -0
- package/dist/cjs/index.js.map +1 -0
- package/dist/cjs/labels/gmail-labels.d.cts +2 -0
- package/dist/cjs/labels/gmail-labels.d.ts +2 -0
- package/dist/cjs/labels/gmail-labels.js +206 -0
- package/dist/cjs/labels/gmail-labels.js.map +1 -0
- package/dist/cjs/lib/base64-encoding.d.cts +2 -0
- package/dist/cjs/lib/base64-encoding.d.ts +2 -0
- package/dist/cjs/lib/base64-encoding.js +32 -0
- package/dist/cjs/lib/base64-encoding.js.map +1 -0
- package/dist/cjs/lib/create-store.d.cts +2 -0
- package/dist/cjs/lib/create-store.d.ts +2 -0
- package/dist/cjs/lib/create-store.js +166 -0
- package/dist/cjs/lib/create-store.js.map +1 -0
- package/dist/cjs/lib/date-conversion.d.cts +1 -0
- package/dist/cjs/lib/date-conversion.d.ts +1 -0
- package/dist/cjs/lib/date-conversion.js +16 -0
- package/dist/cjs/lib/date-conversion.js.map +1 -0
- package/dist/cjs/lib/messages-to-row.d.cts +61 -0
- package/dist/cjs/lib/messages-to-row.d.ts +61 -0
- package/dist/cjs/lib/messages-to-row.js +243 -0
- package/dist/cjs/lib/messages-to-row.js.map +1 -0
- package/dist/cjs/mcp/index.d.cts +3 -0
- package/dist/cjs/mcp/index.d.ts +3 -0
- package/dist/cjs/mcp/index.js +66 -0
- package/dist/cjs/mcp/index.js.map +1 -0
- package/dist/cjs/mcp/prompts/draft-email.d.cts +30 -0
- package/dist/cjs/mcp/prompts/draft-email.d.ts +30 -0
- package/dist/cjs/mcp/prompts/draft-email.js +184 -0
- package/dist/cjs/mcp/prompts/draft-email.js.map +1 -0
- package/dist/cjs/mcp/prompts/index.d.cts +2 -0
- package/dist/cjs/mcp/prompts/index.d.ts +2 -0
- package/dist/cjs/mcp/prompts/index.js +26 -0
- package/dist/cjs/mcp/prompts/index.js.map +1 -0
- package/dist/cjs/mcp/prompts/query-syntax.d.cts +19 -0
- package/dist/cjs/mcp/prompts/query-syntax.d.ts +19 -0
- package/dist/cjs/mcp/prompts/query-syntax.js +169 -0
- package/dist/cjs/mcp/prompts/query-syntax.js.map +1 -0
- package/dist/cjs/mcp/resources/email.d.cts +11 -0
- package/dist/cjs/mcp/resources/email.d.ts +11 -0
- package/dist/cjs/mcp/resources/email.js +256 -0
- package/dist/cjs/mcp/resources/email.js.map +1 -0
- package/dist/cjs/mcp/resources/index.d.cts +1 -0
- package/dist/cjs/mcp/resources/index.d.ts +1 -0
- package/dist/cjs/mcp/resources/index.js +17 -0
- package/dist/cjs/mcp/resources/index.js.map +1 -0
- package/dist/cjs/mcp/tools/categories-list.d.cts +58 -0
- package/dist/cjs/mcp/tools/categories-list.d.ts +58 -0
- package/dist/cjs/mcp/tools/categories-list.js +298 -0
- package/dist/cjs/mcp/tools/categories-list.js.map +1 -0
- package/dist/cjs/mcp/tools/index.d.cts +11 -0
- package/dist/cjs/mcp/tools/index.d.ts +11 -0
- package/dist/cjs/mcp/tools/index.js +62 -0
- package/dist/cjs/mcp/tools/index.js.map +1 -0
- package/dist/cjs/mcp/tools/label-add.d.cts +61 -0
- package/dist/cjs/mcp/tools/label-add.d.ts +61 -0
- package/dist/cjs/mcp/tools/label-add.js +280 -0
- package/dist/cjs/mcp/tools/label-add.js.map +1 -0
- package/dist/cjs/mcp/tools/label-delete.d.cts +71 -0
- package/dist/cjs/mcp/tools/label-delete.d.ts +71 -0
- package/dist/cjs/mcp/tools/label-delete.js +476 -0
- package/dist/cjs/mcp/tools/label-delete.js.map +1 -0
- package/dist/cjs/mcp/tools/labels-list.d.cts +75 -0
- package/dist/cjs/mcp/tools/labels-list.d.ts +75 -0
- package/dist/cjs/mcp/tools/labels-list.js +298 -0
- package/dist/cjs/mcp/tools/labels-list.js.map +1 -0
- package/dist/cjs/mcp/tools/message-get.d.cts +146 -0
- package/dist/cjs/mcp/tools/message-get.d.ts +146 -0
- package/dist/cjs/mcp/tools/message-get.js +317 -0
- package/dist/cjs/mcp/tools/message-get.js.map +1 -0
- package/dist/cjs/mcp/tools/message-mark-read.d.cts +50 -0
- package/dist/cjs/mcp/tools/message-mark-read.d.ts +50 -0
- package/dist/cjs/mcp/tools/message-mark-read.js +254 -0
- package/dist/cjs/mcp/tools/message-mark-read.js.map +1 -0
- package/dist/cjs/mcp/tools/message-move-to-trash.d.cts +71 -0
- package/dist/cjs/mcp/tools/message-move-to-trash.d.ts +71 -0
- package/dist/cjs/mcp/tools/message-move-to-trash.js +450 -0
- package/dist/cjs/mcp/tools/message-move-to-trash.js.map +1 -0
- package/dist/cjs/mcp/tools/message-respond.d.cts +60 -0
- package/dist/cjs/mcp/tools/message-respond.d.ts +60 -0
- package/dist/cjs/mcp/tools/message-respond.js +367 -0
- package/dist/cjs/mcp/tools/message-respond.js.map +1 -0
- package/dist/cjs/mcp/tools/message-search.d.cts +182 -0
- package/dist/cjs/mcp/tools/message-search.d.ts +182 -0
- package/dist/cjs/mcp/tools/message-search.js +405 -0
- package/dist/cjs/mcp/tools/message-search.js.map +1 -0
- package/dist/cjs/mcp/tools/message-send.d.cts +87 -0
- package/dist/cjs/mcp/tools/message-send.d.ts +87 -0
- package/dist/cjs/mcp/tools/message-send.js +288 -0
- package/dist/cjs/mcp/tools/message-send.js.map +1 -0
- package/dist/cjs/mcp/tools/messages-export-csv.d.cts +84 -0
- package/dist/cjs/mcp/tools/messages-export-csv.d.ts +84 -0
- package/dist/cjs/mcp/tools/messages-export-csv.js +530 -0
- package/dist/cjs/mcp/tools/messages-export-csv.js.map +1 -0
- package/dist/cjs/package.json +1 -0
- package/dist/cjs/schemas/gmail-query-schema.d.cts +36 -0
- package/dist/cjs/schemas/gmail-query-schema.d.ts +36 -0
- package/dist/cjs/schemas/gmail-query-schema.js +117 -0
- package/dist/cjs/schemas/gmail-query-schema.js.map +1 -0
- package/dist/cjs/schemas/index.d.cts +1 -0
- package/dist/cjs/schemas/index.d.ts +1 -0
- package/dist/cjs/schemas/index.js +19 -0
- package/dist/cjs/schemas/index.js.map +1 -0
- package/dist/cjs/setup/config.d.cts +48 -0
- package/dist/cjs/setup/config.d.ts +48 -0
- package/dist/cjs/setup/config.js +217 -0
- package/dist/cjs/setup/config.js.map +1 -0
- package/dist/cjs/setup/http.d.cts +8 -0
- package/dist/cjs/setup/http.d.ts +8 -0
- package/dist/cjs/setup/http.js +267 -0
- package/dist/cjs/setup/http.js.map +1 -0
- package/dist/cjs/setup/index.d.cts +5 -0
- package/dist/cjs/setup/index.d.ts +5 -0
- package/dist/cjs/setup/index.js +46 -0
- package/dist/cjs/setup/index.js.map +1 -0
- package/dist/cjs/setup/oauth-google.d.cts +54 -0
- package/dist/cjs/setup/oauth-google.d.ts +54 -0
- package/dist/cjs/setup/oauth-google.js +332 -0
- package/dist/cjs/setup/oauth-google.js.map +1 -0
- package/dist/cjs/setup/runtime.d.cts +12 -0
- package/dist/cjs/setup/runtime.d.ts +12 -0
- package/dist/cjs/setup/runtime.js +489 -0
- package/dist/cjs/setup/runtime.js.map +1 -0
- package/dist/cjs/setup/stdio.d.cts +7 -0
- package/dist/cjs/setup/stdio.d.ts +7 -0
- package/dist/cjs/setup/stdio.js +239 -0
- package/dist/cjs/setup/stdio.js.map +1 -0
- package/dist/cjs/types.d.cts +54 -0
- package/dist/cjs/types.d.ts +54 -0
- package/dist/cjs/types.js +5 -0
- package/dist/cjs/types.js.map +1 -0
- package/dist/esm/constants.d.ts +11 -0
- package/dist/esm/constants.js +14 -0
- package/dist/esm/constants.js.map +1 -0
- package/dist/esm/email/composition/rfc822-builder.d.ts +11 -0
- package/dist/esm/email/composition/rfc822-builder.js +13 -0
- package/dist/esm/email/composition/rfc822-builder.js.map +1 -0
- package/dist/esm/email/messages/fetch-message.d.ts +24 -0
- package/dist/esm/email/messages/fetch-message.js +123 -0
- package/dist/esm/email/messages/fetch-message.js.map +1 -0
- package/dist/esm/email/messages/messages.d.ts +7 -0
- package/dist/esm/email/messages/messages.js +91 -0
- package/dist/esm/email/messages/messages.js.map +1 -0
- package/dist/esm/email/parsing/header-parsing.d.ts +1 -0
- package/dist/esm/email/parsing/header-parsing.js +1 -0
- package/dist/esm/email/parsing/header-parsing.js.map +1 -0
- package/dist/esm/email/parsing/headers-utils.d.ts +5 -0
- package/dist/esm/email/parsing/headers-utils.js +25 -0
- package/dist/esm/email/parsing/headers-utils.js.map +1 -0
- package/dist/esm/email/parsing/html-processing.d.ts +8 -0
- package/dist/esm/email/parsing/html-processing.js +39 -0
- package/dist/esm/email/parsing/html-processing.js.map +1 -0
- package/dist/esm/email/parsing/message-extraction.d.ts +2 -0
- package/dist/esm/email/parsing/message-extraction.js +3 -0
- package/dist/esm/email/parsing/message-extraction.js.map +1 -0
- package/dist/esm/email/querying/execute-query.d.ts +17 -0
- package/dist/esm/email/querying/execute-query.js +45 -0
- package/dist/esm/email/querying/execute-query.js.map +1 -0
- package/dist/esm/email/querying/pagination.d.ts +27 -0
- package/dist/esm/email/querying/pagination.js +152 -0
- package/dist/esm/email/querying/pagination.js.map +1 -0
- package/dist/esm/email/querying/query-builder.d.ts +47 -0
- package/dist/esm/email/querying/query-builder.js +306 -0
- package/dist/esm/email/querying/query-builder.js.map +1 -0
- package/dist/esm/email/querying/search-execution.d.ts +29 -0
- package/dist/esm/email/querying/search-execution.js +35 -0
- package/dist/esm/email/querying/search-execution.js.map +1 -0
- package/dist/esm/index.d.ts +8 -0
- package/dist/esm/index.js +34 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/labels/gmail-labels.d.ts +2 -0
- package/dist/esm/labels/gmail-labels.js +43 -0
- package/dist/esm/labels/gmail-labels.js.map +1 -0
- package/dist/esm/lib/base64-encoding.d.ts +2 -0
- package/dist/esm/lib/base64-encoding.js +13 -0
- package/dist/esm/lib/base64-encoding.js.map +1 -0
- package/dist/esm/lib/create-store.d.ts +2 -0
- package/dist/esm/lib/create-store.js +6 -0
- package/dist/esm/lib/create-store.js.map +1 -0
- package/dist/esm/lib/date-conversion.d.ts +1 -0
- package/dist/esm/lib/date-conversion.js +5 -0
- package/dist/esm/lib/date-conversion.js.map +1 -0
- package/dist/esm/lib/messages-to-row.d.ts +61 -0
- package/dist/esm/lib/messages-to-row.js +188 -0
- package/dist/esm/lib/messages-to-row.js.map +1 -0
- package/dist/esm/mcp/index.d.ts +3 -0
- package/dist/esm/mcp/index.js +6 -0
- package/dist/esm/mcp/index.js.map +1 -0
- package/dist/esm/mcp/prompts/draft-email.d.ts +30 -0
- package/dist/esm/mcp/prompts/draft-email.js +37 -0
- package/dist/esm/mcp/prompts/draft-email.js.map +1 -0
- package/dist/esm/mcp/prompts/index.d.ts +2 -0
- package/dist/esm/mcp/prompts/index.js +2 -0
- package/dist/esm/mcp/prompts/index.js.map +1 -0
- package/dist/esm/mcp/prompts/query-syntax.d.ts +19 -0
- package/dist/esm/mcp/prompts/query-syntax.js +74 -0
- package/dist/esm/mcp/prompts/query-syntax.js.map +1 -0
- package/dist/esm/mcp/resources/email.d.ts +11 -0
- package/dist/esm/mcp/resources/email.js +92 -0
- package/dist/esm/mcp/resources/email.js.map +1 -0
- package/dist/esm/mcp/resources/index.d.ts +1 -0
- package/dist/esm/mcp/resources/index.js +1 -0
- package/dist/esm/mcp/resources/index.js.map +1 -0
- package/dist/esm/mcp/tools/categories-list.d.ts +58 -0
- package/dist/esm/mcp/tools/categories-list.js +124 -0
- package/dist/esm/mcp/tools/categories-list.js.map +1 -0
- package/dist/esm/mcp/tools/index.d.ts +11 -0
- package/dist/esm/mcp/tools/index.js +11 -0
- package/dist/esm/mcp/tools/index.js.map +1 -0
- package/dist/esm/mcp/tools/label-add.d.ts +61 -0
- package/dist/esm/mcp/tools/label-add.js +101 -0
- package/dist/esm/mcp/tools/label-add.js.map +1 -0
- package/dist/esm/mcp/tools/label-delete.d.ts +71 -0
- package/dist/esm/mcp/tools/label-delete.js +186 -0
- package/dist/esm/mcp/tools/label-delete.js.map +1 -0
- package/dist/esm/mcp/tools/labels-list.d.ts +75 -0
- package/dist/esm/mcp/tools/labels-list.js +122 -0
- package/dist/esm/mcp/tools/labels-list.js.map +1 -0
- package/dist/esm/mcp/tools/message-get.d.ts +146 -0
- package/dist/esm/mcp/tools/message-get.js +145 -0
- package/dist/esm/mcp/tools/message-get.js.map +1 -0
- package/dist/esm/mcp/tools/message-mark-read.d.ts +50 -0
- package/dist/esm/mcp/tools/message-mark-read.js +80 -0
- package/dist/esm/mcp/tools/message-mark-read.js.map +1 -0
- package/dist/esm/mcp/tools/message-move-to-trash.d.ts +71 -0
- package/dist/esm/mcp/tools/message-move-to-trash.js +167 -0
- package/dist/esm/mcp/tools/message-move-to-trash.js.map +1 -0
- package/dist/esm/mcp/tools/message-respond.d.ts +60 -0
- package/dist/esm/mcp/tools/message-respond.js +152 -0
- package/dist/esm/mcp/tools/message-respond.js.map +1 -0
- package/dist/esm/mcp/tools/message-search.d.ts +182 -0
- package/dist/esm/mcp/tools/message-search.js +180 -0
- package/dist/esm/mcp/tools/message-search.js.map +1 -0
- package/dist/esm/mcp/tools/message-send.d.ts +87 -0
- package/dist/esm/mcp/tools/message-send.js +115 -0
- package/dist/esm/mcp/tools/message-send.js.map +1 -0
- package/dist/esm/mcp/tools/messages-export-csv.d.ts +84 -0
- package/dist/esm/mcp/tools/messages-export-csv.js +261 -0
- package/dist/esm/mcp/tools/messages-export-csv.js.map +1 -0
- package/dist/esm/package.json +1 -0
- package/dist/esm/schemas/gmail-query-schema.d.ts +36 -0
- package/dist/esm/schemas/gmail-query-schema.js +72 -0
- package/dist/esm/schemas/gmail-query-schema.js.map +1 -0
- package/dist/esm/schemas/index.d.ts +1 -0
- package/dist/esm/schemas/index.js +1 -0
- package/dist/esm/schemas/index.js.map +1 -0
- package/dist/esm/setup/config.d.ts +48 -0
- package/dist/esm/setup/config.js +175 -0
- package/dist/esm/setup/config.js.map +1 -0
- package/dist/esm/setup/http.d.ts +8 -0
- package/dist/esm/setup/http.js +61 -0
- package/dist/esm/setup/http.js.map +1 -0
- package/dist/esm/setup/index.d.ts +5 -0
- package/dist/esm/setup/index.js +5 -0
- package/dist/esm/setup/index.js.map +1 -0
- package/dist/esm/setup/oauth-google.d.ts +54 -0
- package/dist/esm/setup/oauth-google.js +142 -0
- package/dist/esm/setup/oauth-google.js.map +1 -0
- package/dist/esm/setup/runtime.d.ts +12 -0
- package/dist/esm/setup/runtime.js +115 -0
- package/dist/esm/setup/runtime.js.map +1 -0
- package/dist/esm/setup/stdio.d.ts +7 -0
- package/dist/esm/setup/stdio.js +38 -0
- package/dist/esm/setup/stdio.js.map +1 -0
- package/dist/esm/types.d.ts +54 -0
- package/dist/esm/types.js +1 -0
- package/dist/esm/types.js.map +1 -0
- package/package.json +110 -0
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
import type { EnrichedExtra } from '@mcp-z/oauth-google';
|
|
2
|
+
import { z } from 'zod';
|
|
3
|
+
declare const inputSchema: z.ZodObject<{
|
|
4
|
+
shape: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
|
|
5
|
+
objects: "objects";
|
|
6
|
+
arrays: "arrays";
|
|
7
|
+
}>>>;
|
|
8
|
+
contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
|
|
9
|
+
text: "text";
|
|
10
|
+
html: "html";
|
|
11
|
+
}>>>;
|
|
12
|
+
excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
13
|
+
pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
|
|
14
|
+
pageToken: z.ZodOptional<z.ZodString>;
|
|
15
|
+
query: z.ZodOptional<z.ZodType<import("../../schemas/gmail-query-schema.js").GmailQuery, unknown, z.core.$ZodTypeInternals<import("../../schemas/gmail-query-schema.js").GmailQuery, unknown>>>;
|
|
16
|
+
fields: z.ZodOptional<z.ZodString>;
|
|
17
|
+
}, z.core.$strip>;
|
|
18
|
+
declare const outputSchema: z.ZodUnion<readonly [z.ZodObject<{
|
|
19
|
+
type: z.ZodLiteral<"success">;
|
|
20
|
+
shape: z.ZodLiteral<"objects">;
|
|
21
|
+
items: z.ZodArray<z.ZodObject<{
|
|
22
|
+
id: z.ZodOptional<z.ZodString>;
|
|
23
|
+
threadId: z.ZodOptional<z.ZodString>;
|
|
24
|
+
subject: z.ZodOptional<z.ZodString>;
|
|
25
|
+
from: z.ZodOptional<z.ZodString>;
|
|
26
|
+
fromName: z.ZodOptional<z.ZodString>;
|
|
27
|
+
to: z.ZodOptional<z.ZodString>;
|
|
28
|
+
cc: z.ZodOptional<z.ZodString>;
|
|
29
|
+
bcc: z.ZodOptional<z.ZodString>;
|
|
30
|
+
date: z.ZodOptional<z.ZodString>;
|
|
31
|
+
receivedDateTime: z.ZodOptional<z.ZodString>;
|
|
32
|
+
snippet: z.ZodOptional<z.ZodString>;
|
|
33
|
+
isRead: z.ZodOptional<z.ZodBoolean>;
|
|
34
|
+
isImportant: z.ZodOptional<z.ZodBoolean>;
|
|
35
|
+
hasAttachments: z.ZodOptional<z.ZodBoolean>;
|
|
36
|
+
attachmentCount: z.ZodOptional<z.ZodNumber>;
|
|
37
|
+
labelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
38
|
+
folderName: z.ZodOptional<z.ZodString>;
|
|
39
|
+
body: z.ZodOptional<z.ZodString>;
|
|
40
|
+
bodyContentType: z.ZodOptional<z.ZodEnum<{
|
|
41
|
+
text: "text";
|
|
42
|
+
html: "html";
|
|
43
|
+
}>>;
|
|
44
|
+
attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
45
|
+
id: z.ZodString;
|
|
46
|
+
filename: z.ZodString;
|
|
47
|
+
mimeType: z.ZodString;
|
|
48
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
49
|
+
}, z.core.$strip>>>;
|
|
50
|
+
}, z.core.$strip>>;
|
|
51
|
+
nextPageToken: z.ZodOptional<z.ZodString>;
|
|
52
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
53
|
+
type: z.ZodLiteral<"success">;
|
|
54
|
+
shape: z.ZodLiteral<"arrays">;
|
|
55
|
+
columns: z.ZodArray<z.ZodString>;
|
|
56
|
+
rows: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
|
|
57
|
+
nextPageToken: z.ZodOptional<z.ZodString>;
|
|
58
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
59
|
+
type: z.ZodLiteral<"auth_required">;
|
|
60
|
+
provider: z.ZodString;
|
|
61
|
+
message: z.ZodString;
|
|
62
|
+
url: z.ZodOptional<z.ZodString>;
|
|
63
|
+
}, z.core.$strip>]>;
|
|
64
|
+
export type Input = z.infer<typeof inputSchema>;
|
|
65
|
+
export type Output = z.infer<typeof outputSchema>;
|
|
66
|
+
declare function handler({ query, pageSize, pageToken, fields, shape, contentType, excludeThreadHistory }: Input, extra: EnrichedExtra): Promise<{
|
|
67
|
+
content: {
|
|
68
|
+
type: "text";
|
|
69
|
+
text: string;
|
|
70
|
+
}[];
|
|
71
|
+
structuredContent: {
|
|
72
|
+
result: {
|
|
73
|
+
type: "success";
|
|
74
|
+
shape: "objects";
|
|
75
|
+
items: {
|
|
76
|
+
id?: string;
|
|
77
|
+
threadId?: string;
|
|
78
|
+
subject?: string;
|
|
79
|
+
from?: string;
|
|
80
|
+
fromName?: string;
|
|
81
|
+
to?: string;
|
|
82
|
+
cc?: string;
|
|
83
|
+
bcc?: string;
|
|
84
|
+
date?: string;
|
|
85
|
+
receivedDateTime?: string;
|
|
86
|
+
snippet?: string;
|
|
87
|
+
isRead?: boolean;
|
|
88
|
+
isImportant?: boolean;
|
|
89
|
+
hasAttachments?: boolean;
|
|
90
|
+
attachmentCount?: number;
|
|
91
|
+
labelIds?: string[];
|
|
92
|
+
folderName?: string;
|
|
93
|
+
body?: string;
|
|
94
|
+
bodyContentType?: "text" | "html";
|
|
95
|
+
attachments?: {
|
|
96
|
+
id: string;
|
|
97
|
+
filename: string;
|
|
98
|
+
mimeType: string;
|
|
99
|
+
size?: number;
|
|
100
|
+
}[];
|
|
101
|
+
}[];
|
|
102
|
+
nextPageToken?: string;
|
|
103
|
+
} | {
|
|
104
|
+
type: "success";
|
|
105
|
+
shape: "arrays";
|
|
106
|
+
columns: string[];
|
|
107
|
+
rows: unknown[][];
|
|
108
|
+
nextPageToken?: string;
|
|
109
|
+
};
|
|
110
|
+
};
|
|
111
|
+
}>;
|
|
112
|
+
export default function createTool(): {
|
|
113
|
+
name: string;
|
|
114
|
+
config: {
|
|
115
|
+
readonly description: "Search Gmail messages using structured query objects with flexible field selection.";
|
|
116
|
+
readonly inputSchema: z.ZodObject<{
|
|
117
|
+
shape: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
|
|
118
|
+
objects: "objects";
|
|
119
|
+
arrays: "arrays";
|
|
120
|
+
}>>>;
|
|
121
|
+
contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
|
|
122
|
+
text: "text";
|
|
123
|
+
html: "html";
|
|
124
|
+
}>>>;
|
|
125
|
+
excludeThreadHistory: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
|
|
126
|
+
pageSize: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
|
|
127
|
+
pageToken: z.ZodOptional<z.ZodString>;
|
|
128
|
+
query: z.ZodOptional<z.ZodType<import("../../schemas/gmail-query-schema.js").GmailQuery, unknown, z.core.$ZodTypeInternals<import("../../schemas/gmail-query-schema.js").GmailQuery, unknown>>>;
|
|
129
|
+
fields: z.ZodOptional<z.ZodString>;
|
|
130
|
+
}, z.core.$strip>;
|
|
131
|
+
readonly outputSchema: z.ZodObject<{
|
|
132
|
+
result: z.ZodUnion<readonly [z.ZodObject<{
|
|
133
|
+
type: z.ZodLiteral<"success">;
|
|
134
|
+
shape: z.ZodLiteral<"objects">;
|
|
135
|
+
items: z.ZodArray<z.ZodObject<{
|
|
136
|
+
id: z.ZodOptional<z.ZodString>;
|
|
137
|
+
threadId: z.ZodOptional<z.ZodString>;
|
|
138
|
+
subject: z.ZodOptional<z.ZodString>;
|
|
139
|
+
from: z.ZodOptional<z.ZodString>;
|
|
140
|
+
fromName: z.ZodOptional<z.ZodString>;
|
|
141
|
+
to: z.ZodOptional<z.ZodString>;
|
|
142
|
+
cc: z.ZodOptional<z.ZodString>;
|
|
143
|
+
bcc: z.ZodOptional<z.ZodString>;
|
|
144
|
+
date: z.ZodOptional<z.ZodString>;
|
|
145
|
+
receivedDateTime: z.ZodOptional<z.ZodString>;
|
|
146
|
+
snippet: z.ZodOptional<z.ZodString>;
|
|
147
|
+
isRead: z.ZodOptional<z.ZodBoolean>;
|
|
148
|
+
isImportant: z.ZodOptional<z.ZodBoolean>;
|
|
149
|
+
hasAttachments: z.ZodOptional<z.ZodBoolean>;
|
|
150
|
+
attachmentCount: z.ZodOptional<z.ZodNumber>;
|
|
151
|
+
labelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
|
|
152
|
+
folderName: z.ZodOptional<z.ZodString>;
|
|
153
|
+
body: z.ZodOptional<z.ZodString>;
|
|
154
|
+
bodyContentType: z.ZodOptional<z.ZodEnum<{
|
|
155
|
+
text: "text";
|
|
156
|
+
html: "html";
|
|
157
|
+
}>>;
|
|
158
|
+
attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
159
|
+
id: z.ZodString;
|
|
160
|
+
filename: z.ZodString;
|
|
161
|
+
mimeType: z.ZodString;
|
|
162
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
163
|
+
}, z.core.$strip>>>;
|
|
164
|
+
}, z.core.$strip>>;
|
|
165
|
+
nextPageToken: z.ZodOptional<z.ZodString>;
|
|
166
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
167
|
+
type: z.ZodLiteral<"success">;
|
|
168
|
+
shape: z.ZodLiteral<"arrays">;
|
|
169
|
+
columns: z.ZodArray<z.ZodString>;
|
|
170
|
+
rows: z.ZodArray<z.ZodArray<z.ZodUnknown>>;
|
|
171
|
+
nextPageToken: z.ZodOptional<z.ZodString>;
|
|
172
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
173
|
+
type: z.ZodLiteral<"auth_required">;
|
|
174
|
+
provider: z.ZodString;
|
|
175
|
+
message: z.ZodString;
|
|
176
|
+
url: z.ZodOptional<z.ZodString>;
|
|
177
|
+
}, z.core.$strip>]>;
|
|
178
|
+
}, z.core.$strip>;
|
|
179
|
+
};
|
|
180
|
+
handler: typeof handler;
|
|
181
|
+
};
|
|
182
|
+
export {};
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
|
|
2
|
+
/** Gmail message search using middleware-based auth pattern */ import { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, EmailDetailSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';
|
|
3
|
+
import { schemas } from '@mcp-z/oauth-google';
|
|
4
|
+
const { AuthRequiredBranchSchema } = schemas;
|
|
5
|
+
import { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, toColumnarFormat } from '@mcp-z/server';
|
|
6
|
+
import { google } from 'googleapis';
|
|
7
|
+
import { z } from 'zod';
|
|
8
|
+
import { DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE } from '../../constants.js';
|
|
9
|
+
import { extractBodyFromPayload } from '../../email/parsing/html-processing.js';
|
|
10
|
+
import { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.js';
|
|
11
|
+
import { GmailQuerySchema } from '../../schemas/gmail-query-schema.js';
|
|
12
|
+
const inputSchema = z.object({
|
|
13
|
+
query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),
|
|
14
|
+
fields: createFieldsSchema({
|
|
15
|
+
availableFields: EMAIL_FIELDS,
|
|
16
|
+
fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,
|
|
17
|
+
commonPatterns: EMAIL_COMMON_PATTERNS,
|
|
18
|
+
resourceName: 'email message'
|
|
19
|
+
}),
|
|
20
|
+
...createPaginationSchema({
|
|
21
|
+
defaultPageSize: DEFAULT_PAGE_SIZE,
|
|
22
|
+
maxPageSize: MAX_PAGE_SIZE,
|
|
23
|
+
provider: 'gmail'
|
|
24
|
+
}).shape,
|
|
25
|
+
shape: createShapeSchema(),
|
|
26
|
+
contentType: EmailContentTypeSchema,
|
|
27
|
+
excludeThreadHistory: ExcludeThreadHistorySchema
|
|
28
|
+
});
|
|
29
|
+
// Success branch schemas for different shapes
|
|
30
|
+
const successObjectsBranchSchema = z.object({
|
|
31
|
+
type: z.literal('success'),
|
|
32
|
+
shape: z.literal('objects'),
|
|
33
|
+
items: z.array(EmailDetailSchema).describe('Matching email messages'),
|
|
34
|
+
nextPageToken: z.string().optional().describe('Token for fetching next page of results')
|
|
35
|
+
});
|
|
36
|
+
const successArraysBranchSchema = z.object({
|
|
37
|
+
type: z.literal('success'),
|
|
38
|
+
shape: z.literal('arrays'),
|
|
39
|
+
columns: z.array(z.string()).describe('Column names in canonical order'),
|
|
40
|
+
rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),
|
|
41
|
+
nextPageToken: z.string().optional().describe('Token for fetching next page of results')
|
|
42
|
+
});
|
|
43
|
+
// Output schema with auth_required support
|
|
44
|
+
// Using z.union instead of discriminatedUnion since we have two success branches with different shapes
|
|
45
|
+
const outputSchema = z.union([
|
|
46
|
+
successObjectsBranchSchema,
|
|
47
|
+
successArraysBranchSchema,
|
|
48
|
+
AuthRequiredBranchSchema
|
|
49
|
+
]);
|
|
50
|
+
const config = {
|
|
51
|
+
description: 'Search Gmail messages using structured query objects with flexible field selection.',
|
|
52
|
+
inputSchema: inputSchema,
|
|
53
|
+
outputSchema: z.object({
|
|
54
|
+
result: outputSchema
|
|
55
|
+
})
|
|
56
|
+
};
|
|
57
|
+
async function handler({ query, pageSize = DEFAULT_PAGE_SIZE, pageToken, fields, shape = 'arrays', contentType = 'text', excludeThreadHistory = false }, extra) {
|
|
58
|
+
const logger = extra.logger;
|
|
59
|
+
const requestedFields = parseFields(fields, EMAIL_FIELDS);
|
|
60
|
+
const includeBody = requestedFields === 'all' || requestedFields.has('body');
|
|
61
|
+
logger.info('gmail.message.search called', {
|
|
62
|
+
query,
|
|
63
|
+
pageSize,
|
|
64
|
+
pageToken: pageToken ? '[provided]' : undefined,
|
|
65
|
+
fields,
|
|
66
|
+
includeBody,
|
|
67
|
+
accountId: extra.authContext.accountId
|
|
68
|
+
});
|
|
69
|
+
try {
|
|
70
|
+
const gmail = google.gmail({
|
|
71
|
+
version: 'v1',
|
|
72
|
+
auth: extra.authContext.auth
|
|
73
|
+
});
|
|
74
|
+
const started = Date.now();
|
|
75
|
+
const exec = await executeGmailQuery(query, {
|
|
76
|
+
client: gmail,
|
|
77
|
+
logger,
|
|
78
|
+
pageSize,
|
|
79
|
+
...pageToken !== undefined && {
|
|
80
|
+
pageToken
|
|
81
|
+
},
|
|
82
|
+
includeBody
|
|
83
|
+
}, (full)=>{
|
|
84
|
+
var _ref;
|
|
85
|
+
var _fullData_payload;
|
|
86
|
+
// Type-safe property access with guards
|
|
87
|
+
const fullData = full;
|
|
88
|
+
const headersArray = Array.isArray(fullData === null || fullData === void 0 ? void 0 : (_fullData_payload = fullData.payload) === null || _fullData_payload === void 0 ? void 0 : _fullData_payload.headers) ? fullData.payload.headers : [];
|
|
89
|
+
const headers = Object.fromEntries(headersArray.map((h)=>{
|
|
90
|
+
var _header_name, _header_value;
|
|
91
|
+
const header = h;
|
|
92
|
+
return [
|
|
93
|
+
String((_header_name = header.name) !== null && _header_name !== void 0 ? _header_name : ''),
|
|
94
|
+
String((_header_value = header.value) !== null && _header_value !== void 0 ? _header_value : '')
|
|
95
|
+
];
|
|
96
|
+
}));
|
|
97
|
+
const mapped = {
|
|
98
|
+
id: String((_ref = fullData === null || fullData === void 0 ? void 0 : fullData.id) !== null && _ref !== void 0 ? _ref : ''),
|
|
99
|
+
threadId: (fullData === null || fullData === void 0 ? void 0 : fullData.threadId) ? String(fullData.threadId) : undefined,
|
|
100
|
+
from: headers === null || headers === void 0 ? void 0 : headers.From,
|
|
101
|
+
to: headers === null || headers === void 0 ? void 0 : headers.To,
|
|
102
|
+
subject: headers === null || headers === void 0 ? void 0 : headers.Subject,
|
|
103
|
+
date: headers === null || headers === void 0 ? void 0 : headers.Date,
|
|
104
|
+
snippet: (fullData === null || fullData === void 0 ? void 0 : fullData.snippet) ? String(fullData.snippet) : undefined
|
|
105
|
+
};
|
|
106
|
+
if (includeBody) {
|
|
107
|
+
const payload = fullData === null || fullData === void 0 ? void 0 : fullData.payload;
|
|
108
|
+
// Cast to Schema$MessagePart for extractBodyFromPayload
|
|
109
|
+
const body = payload ? extractBodyFromPayload(payload, {
|
|
110
|
+
contentType,
|
|
111
|
+
excludeThreadHistory
|
|
112
|
+
}) : '';
|
|
113
|
+
if (body) {
|
|
114
|
+
mapped.body = body;
|
|
115
|
+
mapped.bodyContentType = contentType;
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
return mapped;
|
|
119
|
+
});
|
|
120
|
+
const items = exec.items;
|
|
121
|
+
const metadata = exec.metadata;
|
|
122
|
+
const durationMs = Date.now() - started;
|
|
123
|
+
// Type-safe field filtering
|
|
124
|
+
const filteredItems = items.map((item)=>filterFields(item, requestedFields));
|
|
125
|
+
logger.info('gmail.message.search results', {
|
|
126
|
+
query,
|
|
127
|
+
pageSize,
|
|
128
|
+
resultCount: filteredItems.length,
|
|
129
|
+
fields: fields || 'all'
|
|
130
|
+
});
|
|
131
|
+
logger.info('gmail.message.search metrics', {
|
|
132
|
+
durationMs,
|
|
133
|
+
metadata
|
|
134
|
+
});
|
|
135
|
+
// Type-safe metadata access
|
|
136
|
+
const metadataObj = metadata;
|
|
137
|
+
// Build result based on shape
|
|
138
|
+
const result = shape === 'arrays' ? {
|
|
139
|
+
type: 'success',
|
|
140
|
+
shape: 'arrays',
|
|
141
|
+
...toColumnarFormat(filteredItems, requestedFields, EMAIL_FIELDS),
|
|
142
|
+
...(metadataObj === null || metadataObj === void 0 ? void 0 : metadataObj.nextPageToken) && {
|
|
143
|
+
nextPageToken: metadataObj.nextPageToken
|
|
144
|
+
}
|
|
145
|
+
} : {
|
|
146
|
+
type: 'success',
|
|
147
|
+
shape: 'objects',
|
|
148
|
+
items: filteredItems,
|
|
149
|
+
...(metadataObj === null || metadataObj === void 0 ? void 0 : metadataObj.nextPageToken) && {
|
|
150
|
+
nextPageToken: metadataObj.nextPageToken
|
|
151
|
+
}
|
|
152
|
+
};
|
|
153
|
+
return {
|
|
154
|
+
content: [
|
|
155
|
+
{
|
|
156
|
+
type: 'text',
|
|
157
|
+
text: JSON.stringify(result)
|
|
158
|
+
}
|
|
159
|
+
],
|
|
160
|
+
structuredContent: {
|
|
161
|
+
result
|
|
162
|
+
}
|
|
163
|
+
};
|
|
164
|
+
} catch (error) {
|
|
165
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
166
|
+
logger.error('gmail.message.search error', {
|
|
167
|
+
error: message
|
|
168
|
+
});
|
|
169
|
+
throw new McpError(ErrorCode.InternalError, `Error searching messages: ${message}`, {
|
|
170
|
+
stack: error instanceof Error ? error.stack : undefined
|
|
171
|
+
});
|
|
172
|
+
}
|
|
173
|
+
}
|
|
174
|
+
export default function createTool() {
|
|
175
|
+
return {
|
|
176
|
+
name: 'message-search',
|
|
177
|
+
config,
|
|
178
|
+
handler
|
|
179
|
+
};
|
|
180
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/message-search.ts"],"sourcesContent":["import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\n/** Gmail message search using middleware-based auth pattern */\n\nimport { EMAIL_COMMON_PATTERNS, EMAIL_FIELD_DESCRIPTIONS, EMAIL_FIELDS, EmailContentTypeSchema, type EmailDetail, EmailDetailSchema, ExcludeThreadHistorySchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport { createFieldsSchema, createPaginationSchema, createShapeSchema, filterFields, parseFields, type ToolModule, toColumnarFormat } from '@mcp-z/server';\nimport { type gmail_v1, google } from 'googleapis';\nimport { z } from 'zod';\nimport { DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE } from '../../constants.ts';\nimport { extractBodyFromPayload } from '../../email/parsing/html-processing.js';\nimport { executeQuery as executeGmailQuery } from '../../email/querying/execute-query.js';\nimport { GmailQuerySchema } from '../../schemas/gmail-query-schema.js';\n\nconst inputSchema = z.object({\n query: GmailQuerySchema.optional().describe('Structured query object for filtering messages. Use query-syntax prompt for reference.'),\n fields: createFieldsSchema({\n availableFields: EMAIL_FIELDS,\n fieldDescriptions: EMAIL_FIELD_DESCRIPTIONS,\n commonPatterns: EMAIL_COMMON_PATTERNS,\n resourceName: 'email message',\n }),\n ...createPaginationSchema({ defaultPageSize: DEFAULT_PAGE_SIZE, maxPageSize: MAX_PAGE_SIZE, provider: 'gmail' }).shape,\n shape: createShapeSchema(),\n contentType: EmailContentTypeSchema,\n excludeThreadHistory: ExcludeThreadHistorySchema,\n});\n\n// Success branch schemas for different shapes\nconst successObjectsBranchSchema = z.object({\n type: z.literal('success'),\n shape: z.literal('objects'),\n items: z.array(EmailDetailSchema).describe('Matching email messages'),\n nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\nconst successArraysBranchSchema = z.object({\n type: z.literal('success'),\n shape: z.literal('arrays'),\n columns: z.array(z.string()).describe('Column names in canonical order'),\n rows: z.array(z.array(z.unknown())).describe('Row data matching column order'),\n nextPageToken: z.string().optional().describe('Token for fetching next page of results'),\n});\n\n// Output schema with auth_required support\n// Using z.union instead of discriminatedUnion since we have two success branches with different shapes\nconst outputSchema = z.union([successObjectsBranchSchema, successArraysBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Search Gmail messages using structured query objects with flexible field selection.',\n inputSchema: inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler({ query, pageSize = DEFAULT_PAGE_SIZE, pageToken, fields, shape = 'arrays', contentType = 'text', excludeThreadHistory = false }: Input, extra: EnrichedExtra) {\n const logger = extra.logger;\n\n const requestedFields = parseFields(fields, EMAIL_FIELDS);\n const includeBody = requestedFields === 'all' || requestedFields.has('body');\n\n logger.info('gmail.message.search called', {\n query,\n pageSize,\n pageToken: pageToken ? '[provided]' : undefined,\n fields,\n includeBody,\n accountId: extra.authContext.accountId, // Available from middleware\n });\n\n try {\n const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n const started = Date.now();\n\n const exec = await executeGmailQuery(\n query,\n {\n client: gmail,\n logger,\n pageSize,\n ...(pageToken !== undefined && { pageToken }),\n includeBody,\n },\n (full: unknown) => {\n // Type-safe property access with guards\n const fullData = full as gmail_v1.Schema$Message;\n\n const headersArray = Array.isArray(fullData?.payload?.headers) ? fullData.payload.headers : [];\n const headers = Object.fromEntries(\n headersArray.map((h: unknown) => {\n const header = h as gmail_v1.Schema$MessagePartHeader;\n return [String(header.name ?? ''), String(header.value ?? '')];\n })\n );\n\n const mapped: Partial<EmailDetail> = {\n id: String(fullData?.id ?? ''),\n threadId: fullData?.threadId ? String(fullData.threadId) : undefined,\n from: headers?.From,\n to: headers?.To,\n subject: headers?.Subject,\n date: headers?.Date,\n snippet: fullData?.snippet ? String(fullData.snippet) : undefined,\n };\n\n if (includeBody) {\n const payload = fullData?.payload;\n // Cast to Schema$MessagePart for extractBodyFromPayload\n const body = payload ? extractBodyFromPayload(payload as gmail_v1.Schema$MessagePart, { contentType, excludeThreadHistory }) : '';\n if (body) {\n mapped.body = body;\n mapped.bodyContentType = contentType;\n }\n }\n return mapped;\n }\n );\n\n const items = exec.items;\n const metadata = exec.metadata;\n const durationMs = Date.now() - started;\n\n // Type-safe field filtering\n const filteredItems = items.map((item) => filterFields(item, requestedFields));\n\n logger.info('gmail.message.search results', { query, pageSize, resultCount: filteredItems.length, fields: fields || 'all' });\n logger.info('gmail.message.search metrics', { durationMs, metadata });\n\n // Type-safe metadata access\n const metadataObj = metadata as { nextPageToken?: string } | undefined;\n\n // Build result based on shape\n const result: Output =\n shape === 'arrays'\n ? {\n type: 'success' as const,\n shape: 'arrays' as const,\n ...toColumnarFormat(filteredItems, requestedFields, EMAIL_FIELDS),\n ...(metadataObj?.nextPageToken && { nextPageToken: metadataObj.nextPageToken }),\n }\n : {\n type: 'success' as const,\n shape: 'objects' as const,\n items: filteredItems,\n ...(metadataObj?.nextPageToken && { nextPageToken: metadataObj.nextPageToken }),\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('gmail.message.search error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error searching messages: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'message-search',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["ErrorCode","McpError","EMAIL_COMMON_PATTERNS","EMAIL_FIELD_DESCRIPTIONS","EMAIL_FIELDS","EmailContentTypeSchema","EmailDetailSchema","ExcludeThreadHistorySchema","schemas","AuthRequiredBranchSchema","createFieldsSchema","createPaginationSchema","createShapeSchema","filterFields","parseFields","toColumnarFormat","google","z","DEFAULT_PAGE_SIZE","MAX_PAGE_SIZE","extractBodyFromPayload","executeQuery","executeGmailQuery","GmailQuerySchema","inputSchema","object","query","optional","describe","fields","availableFields","fieldDescriptions","commonPatterns","resourceName","defaultPageSize","maxPageSize","provider","shape","contentType","excludeThreadHistory","successObjectsBranchSchema","type","literal","items","array","nextPageToken","string","successArraysBranchSchema","columns","rows","unknown","outputSchema","union","config","description","result","handler","pageSize","pageToken","extra","logger","requestedFields","includeBody","has","info","undefined","accountId","authContext","gmail","version","auth","started","Date","now","exec","client","full","fullData","headersArray","Array","isArray","payload","headers","Object","fromEntries","map","h","header","String","name","value","mapped","id","threadId","from","From","to","To","subject","Subject","date","snippet","body","bodyContentType","metadata","durationMs","filteredItems","item","resultCount","length","metadataObj","content","text","JSON","stringify","structuredContent","error","message","Error","InternalError","stack","createTool"],"mappings":"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"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
import type { EnrichedExtra } from '@mcp-z/oauth-google';
|
|
2
|
+
import { z } from 'zod';
|
|
3
|
+
declare const inputSchema: z.ZodObject<{
|
|
4
|
+
to: z.ZodString | z.ZodOptional<z.ZodString>;
|
|
5
|
+
cc: z.ZodString | z.ZodOptional<z.ZodString>;
|
|
6
|
+
bcc: z.ZodString | z.ZodOptional<z.ZodString>;
|
|
7
|
+
subject: z.ZodDefault<z.ZodString>;
|
|
8
|
+
body: z.ZodString;
|
|
9
|
+
contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
|
|
10
|
+
text: "text";
|
|
11
|
+
html: "html";
|
|
12
|
+
}>>>;
|
|
13
|
+
}, z.core.$strip>;
|
|
14
|
+
declare const outputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
15
|
+
type: z.ZodLiteral<"success">;
|
|
16
|
+
item: z.ZodObject<{
|
|
17
|
+
id: z.ZodString;
|
|
18
|
+
threadId: z.ZodOptional<z.ZodString>;
|
|
19
|
+
sentAt: z.ZodString;
|
|
20
|
+
recipientCount: z.ZodNumber;
|
|
21
|
+
webLink: z.ZodOptional<z.ZodString>;
|
|
22
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
23
|
+
}, z.core.$strip>;
|
|
24
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
25
|
+
type: z.ZodLiteral<"auth_required">;
|
|
26
|
+
provider: z.ZodString;
|
|
27
|
+
message: z.ZodString;
|
|
28
|
+
url: z.ZodOptional<z.ZodString>;
|
|
29
|
+
}, z.core.$strip>], "type">;
|
|
30
|
+
export type Input = z.infer<typeof inputSchema>;
|
|
31
|
+
export type Output = z.infer<typeof outputSchema>;
|
|
32
|
+
declare function handler(params: Input, extra: EnrichedExtra): Promise<{
|
|
33
|
+
content: {
|
|
34
|
+
type: "text";
|
|
35
|
+
text: string;
|
|
36
|
+
}[];
|
|
37
|
+
structuredContent: {
|
|
38
|
+
result: {
|
|
39
|
+
type: "success";
|
|
40
|
+
item: {
|
|
41
|
+
id: string;
|
|
42
|
+
sentAt: string;
|
|
43
|
+
recipientCount: number;
|
|
44
|
+
threadId?: string;
|
|
45
|
+
webLink?: string;
|
|
46
|
+
size?: number;
|
|
47
|
+
};
|
|
48
|
+
};
|
|
49
|
+
};
|
|
50
|
+
}>;
|
|
51
|
+
export default function createTool(): {
|
|
52
|
+
name: string;
|
|
53
|
+
config: {
|
|
54
|
+
readonly description: "Send an email message through Gmail";
|
|
55
|
+
readonly inputSchema: z.ZodObject<{
|
|
56
|
+
to: z.ZodString | z.ZodOptional<z.ZodString>;
|
|
57
|
+
cc: z.ZodString | z.ZodOptional<z.ZodString>;
|
|
58
|
+
bcc: z.ZodString | z.ZodOptional<z.ZodString>;
|
|
59
|
+
subject: z.ZodDefault<z.ZodString>;
|
|
60
|
+
body: z.ZodString;
|
|
61
|
+
contentType: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
|
|
62
|
+
text: "text";
|
|
63
|
+
html: "html";
|
|
64
|
+
}>>>;
|
|
65
|
+
}, z.core.$strip>;
|
|
66
|
+
readonly outputSchema: z.ZodObject<{
|
|
67
|
+
result: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
68
|
+
type: z.ZodLiteral<"success">;
|
|
69
|
+
item: z.ZodObject<{
|
|
70
|
+
id: z.ZodString;
|
|
71
|
+
threadId: z.ZodOptional<z.ZodString>;
|
|
72
|
+
sentAt: z.ZodString;
|
|
73
|
+
recipientCount: z.ZodNumber;
|
|
74
|
+
webLink: z.ZodOptional<z.ZodString>;
|
|
75
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
76
|
+
}, z.core.$strip>;
|
|
77
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
78
|
+
type: z.ZodLiteral<"auth_required">;
|
|
79
|
+
provider: z.ZodString;
|
|
80
|
+
message: z.ZodString;
|
|
81
|
+
url: z.ZodOptional<z.ZodString>;
|
|
82
|
+
}, z.core.$strip>], "type">;
|
|
83
|
+
}, z.core.$strip>;
|
|
84
|
+
};
|
|
85
|
+
handler: typeof handler;
|
|
86
|
+
};
|
|
87
|
+
export {};
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import { ComposeContentTypeSchema, createEmailRecipientsSchema, createMessageResultSchema } from '@mcp-z/email';
|
|
2
|
+
import { schemas } from '@mcp-z/oauth-google';
|
|
3
|
+
const { AuthRequiredBranchSchema } = schemas;
|
|
4
|
+
import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
|
|
5
|
+
import { google } from 'googleapis';
|
|
6
|
+
import { z } from 'zod';
|
|
7
|
+
import { buildRfc822FromArgs } from '../../email/composition/rfc822-builder.js';
|
|
8
|
+
import { b64url } from '../../lib/base64-encoding.js';
|
|
9
|
+
const inputSchema = z.object({
|
|
10
|
+
to: createEmailRecipientsSchema('to', true),
|
|
11
|
+
cc: createEmailRecipientsSchema('cc', false),
|
|
12
|
+
bcc: createEmailRecipientsSchema('bcc', false),
|
|
13
|
+
subject: z.string().describe('Message subject').default(''),
|
|
14
|
+
body: z.string().trim().min(1).describe('Email body content (plain text or HTML)'),
|
|
15
|
+
contentType: ComposeContentTypeSchema
|
|
16
|
+
});
|
|
17
|
+
// Success branch schema
|
|
18
|
+
const successBranchSchema = z.object({
|
|
19
|
+
type: z.literal('success'),
|
|
20
|
+
item: createMessageResultSchema('gmail')
|
|
21
|
+
});
|
|
22
|
+
// Output schema with auth_required support
|
|
23
|
+
const outputSchema = z.discriminatedUnion('type', [
|
|
24
|
+
successBranchSchema,
|
|
25
|
+
AuthRequiredBranchSchema
|
|
26
|
+
]);
|
|
27
|
+
const config = {
|
|
28
|
+
description: 'Send an email message through Gmail',
|
|
29
|
+
inputSchema: inputSchema,
|
|
30
|
+
outputSchema: z.object({
|
|
31
|
+
result: outputSchema
|
|
32
|
+
})
|
|
33
|
+
};
|
|
34
|
+
async function handler(params, extra) {
|
|
35
|
+
const { to, cc, bcc, subject, body, contentType } = params;
|
|
36
|
+
const logger = extra.logger;
|
|
37
|
+
logger.info('gmail.message.send called', {
|
|
38
|
+
to,
|
|
39
|
+
subject,
|
|
40
|
+
contentType
|
|
41
|
+
});
|
|
42
|
+
if (!to) {
|
|
43
|
+
throw new McpError(ErrorCode.InvalidParams, 'Missing required field: to');
|
|
44
|
+
}
|
|
45
|
+
try {
|
|
46
|
+
// Build RFC822 message - only include optional headers when defined to satisfy
|
|
47
|
+
// exactOptionalPropertyTypes (avoid passing `undefined` into optional props)
|
|
48
|
+
const msgArgs = {
|
|
49
|
+
to,
|
|
50
|
+
body,
|
|
51
|
+
contentType
|
|
52
|
+
};
|
|
53
|
+
if (cc !== undefined) msgArgs.cc = cc;
|
|
54
|
+
if (bcc !== undefined) msgArgs.bcc = bcc;
|
|
55
|
+
if (subject !== undefined) msgArgs.subject = subject;
|
|
56
|
+
const raw = buildRfc822FromArgs(msgArgs);
|
|
57
|
+
const encodedMessage = b64url(raw);
|
|
58
|
+
const gmail = google.gmail({
|
|
59
|
+
version: 'v1',
|
|
60
|
+
auth: extra.authContext.auth
|
|
61
|
+
});
|
|
62
|
+
const sendRes = await gmail.users.messages.send({
|
|
63
|
+
userId: 'me',
|
|
64
|
+
requestBody: {
|
|
65
|
+
raw: encodedMessage
|
|
66
|
+
}
|
|
67
|
+
});
|
|
68
|
+
const sendData = sendRes.data;
|
|
69
|
+
const messageId = sendData.id || 'unknown';
|
|
70
|
+
logger.info('Gmail: sent message successfully', {
|
|
71
|
+
id: messageId
|
|
72
|
+
});
|
|
73
|
+
logger.info('gmail.message.send result (typed)', {
|
|
74
|
+
to,
|
|
75
|
+
subject,
|
|
76
|
+
messageId
|
|
77
|
+
});
|
|
78
|
+
const totalRecipients = (Array.isArray(to) ? to.length : 1) + (cc ? Array.isArray(cc) ? cc.length : 1 : 0) + (bcc ? Array.isArray(bcc) ? bcc.length : 1 : 0);
|
|
79
|
+
const result = {
|
|
80
|
+
type: 'success',
|
|
81
|
+
item: {
|
|
82
|
+
id: messageId,
|
|
83
|
+
sentAt: new Date().toISOString(),
|
|
84
|
+
recipientCount: totalRecipients,
|
|
85
|
+
webLink: `https://mail.google.com/mail/u/0/#sent/${messageId}`
|
|
86
|
+
}
|
|
87
|
+
};
|
|
88
|
+
return {
|
|
89
|
+
content: [
|
|
90
|
+
{
|
|
91
|
+
type: 'text',
|
|
92
|
+
text: JSON.stringify(result)
|
|
93
|
+
}
|
|
94
|
+
],
|
|
95
|
+
structuredContent: {
|
|
96
|
+
result
|
|
97
|
+
}
|
|
98
|
+
};
|
|
99
|
+
} catch (error) {
|
|
100
|
+
const message = error instanceof Error ? error.message : String(error);
|
|
101
|
+
logger.error('gmail.message.send error', {
|
|
102
|
+
error: message
|
|
103
|
+
});
|
|
104
|
+
throw new McpError(ErrorCode.InternalError, `Error sending message: ${message}`, {
|
|
105
|
+
stack: error instanceof Error ? error.stack : undefined
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
export default function createTool() {
|
|
110
|
+
return {
|
|
111
|
+
name: 'message-send',
|
|
112
|
+
config,
|
|
113
|
+
handler
|
|
114
|
+
};
|
|
115
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["/Users/kevin/Dev/Projects/ai/mcp-z/servers/mcp-gmail/src/mcp/tools/message-send.ts"],"sourcesContent":["import { ComposeContentTypeSchema, createEmailRecipientsSchema, createMessageResultSchema } from '@mcp-z/email';\nimport type { EnrichedExtra } from '@mcp-z/oauth-google';\nimport { schemas } from '@mcp-z/oauth-google';\n\nconst { AuthRequiredBranchSchema } = schemas;\n\nimport type { ToolModule } from '@mcp-z/server';\nimport { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';\nimport { google } from 'googleapis';\nimport { z } from 'zod';\nimport { buildRfc822FromArgs } from '../../email/composition/rfc822-builder.js';\nimport { b64url } from '../../lib/base64-encoding.js';\n\nconst inputSchema = z.object({\n to: createEmailRecipientsSchema('to', true),\n cc: createEmailRecipientsSchema('cc', false),\n bcc: createEmailRecipientsSchema('bcc', false),\n subject: z.string().describe('Message subject').default(''),\n body: z.string().trim().min(1).describe('Email body content (plain text or HTML)'),\n contentType: ComposeContentTypeSchema,\n});\n\n// Success branch schema\nconst successBranchSchema = z.object({\n type: z.literal('success'),\n item: createMessageResultSchema('gmail'),\n});\n\n// Output schema with auth_required support\nconst outputSchema = z.discriminatedUnion('type', [successBranchSchema, AuthRequiredBranchSchema]);\n\nconst config = {\n description: 'Send an email message through Gmail',\n inputSchema: inputSchema,\n outputSchema: z.object({\n result: outputSchema,\n }),\n} as const;\n\nexport type Input = z.infer<typeof inputSchema>;\nexport type Output = z.infer<typeof outputSchema>;\n\nasync function handler(params: Input, extra: EnrichedExtra) {\n const { to, cc, bcc, subject, body, contentType } = params;\n const logger = extra.logger;\n logger.info('gmail.message.send called', { to, subject, contentType });\n\n if (!to) {\n throw new McpError(ErrorCode.InvalidParams, 'Missing required field: to');\n }\n\n try {\n // Build RFC822 message - only include optional headers when defined to satisfy\n // exactOptionalPropertyTypes (avoid passing `undefined` into optional props)\n const msgArgs: { to: string; cc?: string; bcc?: string; subject?: string; body: string; contentType: 'text' | 'html' } = { to, body, contentType };\n if (cc !== undefined) msgArgs.cc = cc;\n if (bcc !== undefined) msgArgs.bcc = bcc;\n if (subject !== undefined) msgArgs.subject = subject;\n\n const raw = buildRfc822FromArgs(msgArgs);\n const encodedMessage = b64url(raw);\n\n const gmail = google.gmail({ version: 'v1', auth: extra.authContext.auth });\n\n const sendRes = await gmail.users.messages.send({\n userId: 'me',\n requestBody: { raw: encodedMessage },\n });\n const sendData = sendRes.data;\n const messageId = sendData.id || 'unknown';\n logger.info('Gmail: sent message successfully', { id: messageId });\n logger.info('gmail.message.send result (typed)', { to, subject, messageId });\n\n const totalRecipients = (Array.isArray(to) ? to.length : 1) + (cc ? (Array.isArray(cc) ? cc.length : 1) : 0) + (bcc ? (Array.isArray(bcc) ? bcc.length : 1) : 0);\n const result: Output = {\n type: 'success' as const,\n item: {\n id: messageId,\n sentAt: new Date().toISOString(),\n recipientCount: totalRecipients,\n webLink: `https://mail.google.com/mail/u/0/#sent/${messageId}`,\n },\n };\n\n return {\n content: [\n {\n type: 'text' as const,\n text: JSON.stringify(result),\n },\n ],\n structuredContent: { result },\n };\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error);\n logger.error('gmail.message.send error', { error: message });\n\n throw new McpError(ErrorCode.InternalError, `Error sending message: ${message}`, {\n stack: error instanceof Error ? error.stack : undefined,\n });\n }\n}\n\nexport default function createTool() {\n return {\n name: 'message-send',\n config,\n handler,\n } satisfies ToolModule;\n}\n"],"names":["ComposeContentTypeSchema","createEmailRecipientsSchema","createMessageResultSchema","schemas","AuthRequiredBranchSchema","ErrorCode","McpError","google","z","buildRfc822FromArgs","b64url","inputSchema","object","to","cc","bcc","subject","string","describe","default","body","trim","min","contentType","successBranchSchema","type","literal","item","outputSchema","discriminatedUnion","config","description","result","handler","params","extra","logger","info","InvalidParams","msgArgs","undefined","raw","encodedMessage","gmail","version","auth","authContext","sendRes","users","messages","send","userId","requestBody","sendData","data","messageId","id","totalRecipients","Array","isArray","length","sentAt","Date","toISOString","recipientCount","webLink","content","text","JSON","stringify","structuredContent","error","message","Error","String","InternalError","stack","createTool","name"],"mappings":"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"}
|