@node2flow/gmail-mcp 1.0.0

package/src/types.ts

@@ -0,0 +1,238 @@
+/**
+ * Gmail API v1 Types
+ */
+
+// ========== Message ==========
+
+export interface Message {
+  id: string;
+  threadId: string;
+  labelIds?: string[];
+  snippet?: string;
+  historyId?: string;
+  internalDate?: string;
+  payload?: MessagePart;
+  sizeEstimate?: number;
+  raw?: string;
+}
+
+export interface MessagePart {
+  partId?: string;
+  mimeType?: string;
+  filename?: string;
+  headers?: MessagePartHeader[];
+  body?: MessagePartBody;
+  parts?: MessagePart[];
+}
+
+export interface MessagePartHeader {
+  name: string;
+  value: string;
+}
+
+export interface MessagePartBody {
+  attachmentId?: string;
+  size?: number;
+  data?: string;
+}
+
+export interface MessageList {
+  messages?: MessageRef[];
+  nextPageToken?: string;
+  resultSizeEstimate?: number;
+}
+
+export interface MessageRef {
+  id: string;
+  threadId: string;
+}
+
+// ========== Thread ==========
+
+export interface Thread {
+  id: string;
+  historyId?: string;
+  messages?: Message[];
+  snippet?: string;
+}
+
+export interface ThreadList {
+  threads?: ThreadRef[];
+  nextPageToken?: string;
+  resultSizeEstimate?: number;
+}
+
+export interface ThreadRef {
+  id: string;
+  historyId?: string;
+  snippet?: string;
+}
+
+// ========== Label ==========
+
+export interface Label {
+  id: string;
+  name: string;
+  messageListVisibility?: 'show' | 'hide';
+  labelListVisibility?: 'labelShow' | 'labelShowIfUnread' | 'labelHide';
+  type?: 'system' | 'user';
+  messagesTotal?: number;
+  messagesUnread?: number;
+  threadsTotal?: number;
+  threadsUnread?: number;
+  color?: LabelColor;
+}
+
+export interface LabelColor {
+  textColor?: string;
+  backgroundColor?: string;
+}
+
+export interface LabelList {
+  labels: Label[];
+}
+
+// ========== Draft ==========
+
+export interface Draft {
+  id: string;
+  message?: Message;
+}
+
+export interface DraftList {
+  drafts?: DraftRef[];
+  nextPageToken?: string;
+  resultSizeEstimate?: number;
+}
+
+export interface DraftRef {
+  id: string;
+  message?: MessageRef;
+}
+
+// ========== Profile ==========
+
+export interface Profile {
+  emailAddress: string;
+  messagesTotal: number;
+  threadsTotal: number;
+  historyId: string;
+}
+
+// ========== Vacation Settings ==========
+
+export interface VacationSettings {
+  enableAutoReply: boolean;
+  responseSubject?: string;
+  responseBodyPlainText?: string;
+  responseBodyHtml?: string;
+  restrictToContacts?: boolean;
+  restrictToDomain?: boolean;
+  startTime?: string;
+  endTime?: string;
+}
+
+// ========== History ==========
+
+export interface HistoryList {
+  history?: HistoryRecord[];
+  nextPageToken?: string;
+  historyId: string;
+}
+
+export interface HistoryRecord {
+  id: string;
+  messages?: Message[];
+  messagesAdded?: MessageAdded[];
+  messagesDeleted?: MessageDeleted[];
+  labelsAdded?: LabelModification[];
+  labelsRemoved?: LabelModification[];
+}
+
+export interface MessageAdded {
+  message: Message;
+}
+
+export interface MessageDeleted {
+  message: Message;
+}
+
+export interface LabelModification {
+  message: Message;
+  labelIds: string[];
+}
+
+// ========== Filter ==========
+
+export interface Filter {
+  id: string;
+  criteria?: FilterCriteria;
+  action?: FilterAction;
+}
+
+export interface FilterCriteria {
+  from?: string;
+  to?: string;
+  subject?: string;
+  query?: string;
+  negatedQuery?: string;
+  hasAttachment?: boolean;
+  excludeChats?: boolean;
+  size?: number;
+  sizeComparison?: 'larger' | 'smaller';
+}
+
+export interface FilterAction {
+  addLabelIds?: string[];
+  removeLabelIds?: string[];
+  forward?: string;
+}
+
+export interface FilterList {
+  filter: Filter[];
+}
+
+// ========== Attachment ==========
+
+export interface Attachment {
+  size: number;
+  data: string;
+}
+
+// ========== Modify Request ==========
+
+export interface ModifyRequest {
+  addLabelIds?: string[];
+  removeLabelIds?: string[];
+}
+
+// ========== Batch Request ==========
+
+export interface BatchDeleteRequest {
+  ids: string[];
+}
+
+export interface BatchModifyRequest {
+  ids: string[];
+  addLabelIds?: string[];
+  removeLabelIds?: string[];
+}
+
+// ========== Tool Definition ==========
+
+export interface MCPToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required?: string[];
+  };
+  annotations?: {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+  };
+}

package/src/worker.ts

@@ -0,0 +1,88 @@
+/**
+ * Cloudflare Worker entry — Stateless Streamable HTTP MCP
+ */
+
+import {
+  WebStandardStreamableHTTPServerTransport,
+} from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
+
+import { createServer } from './server.js';
+import { TOOLS } from './tools.js';
+
+function corsHeaders(): Record<string, string> {
+  return {
+    'Access-Control-Allow-Origin': '*',
+    'Access-Control-Allow-Methods': 'GET, POST, DELETE, OPTIONS',
+    'Access-Control-Allow-Headers': 'Content-Type, mcp-session-id, Accept, mcp-protocol-version',
+    'Access-Control-Expose-Headers': 'mcp-session-id',
+  };
+}
+
+function addCors(response: Response): Response {
+  const headers = new Headers(response.headers);
+  for (const [key, value] of Object.entries(corsHeaders())) {
+    headers.set(key, value);
+  }
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers,
+  });
+}
+
+export default {
+  async fetch(request: Request): Promise<Response> {
+    const url = new URL(request.url);
+
+    if (request.method === 'OPTIONS') {
+      return new Response(null, { status: 204, headers: corsHeaders() });
+    }
+
+    if (url.pathname === '/' && request.method === 'GET') {
+      return addCors(Response.json({
+        name: 'gmail-mcp',
+        version: '1.0.0',
+        status: 'ok',
+        tools: TOOLS.length,
+        transport: 'streamable-http',
+        endpoints: { mcp: '/mcp' },
+      }));
+    }
+
+    if (url.pathname !== '/mcp') {
+      return addCors(new Response('Not Found', { status: 404 }));
+    }
+
+    if (request.method !== 'POST') {
+      return addCors(Response.json(
+        { jsonrpc: '2.0', error: { code: -32000, message: 'Method not allowed. Use POST.' }, id: null },
+        { status: 405 }
+      ));
+    }
+
+    const clientId = url.searchParams.get('GOOGLE_CLIENT_ID') || '';
+    const clientSecret = url.searchParams.get('GOOGLE_CLIENT_SECRET') || '';
+    const refreshToken = url.searchParams.get('GOOGLE_REFRESH_TOKEN') || '';
+    const config = clientId && clientSecret && refreshToken
+      ? { clientId, clientSecret, refreshToken }
+      : undefined;
+
+    try {
+      const transport = new WebStandardStreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+        enableJsonResponse: true,
+      });
+
+      const server = createServer(config);
+      await server.connect(transport);
+
+      const response = await transport.handleRequest(request);
+      return addCors(response);
+    } catch (error: any) {
+      return addCors(Response.json(
+        { jsonrpc: '2.0', error: { code: -32603, message: error.message || 'Internal server error' }, id: null },
+        { status: 500 }
+      ));
+    }
+  },
+};

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/wrangler.toml

@@ -0,0 +1,14 @@
+name = "gmail-mcp-community"
+main = "src/worker.ts"
+compatibility_date = "2025-01-01"
+workers_dev = true
+
+[[routes]]
+pattern = "gmail-mcp-community.node2flow.net"
+custom_domain = true
+
+[placement]
+mode = "smart"
+
+[observability]
+enabled = true