@node2flow/google-calendar-mcp 1.0.0

package/src/types.ts

@@ -0,0 +1,317 @@
+/**
+ * Google Calendar API v3 Types
+ */
+
+// ========== DateTime ==========
+
+export interface EventDateTime {
+  date?: string;
+  dateTime?: string;
+  timeZone?: string;
+}
+
+// ========== Event ==========
+
+export interface Event {
+  kind?: string;
+  etag?: string;
+  id?: string;
+  status?: string;
+  htmlLink?: string;
+  created?: string;
+  updated?: string;
+  summary?: string;
+  description?: string;
+  location?: string;
+  colorId?: string;
+  creator?: EventPerson;
+  organizer?: EventPerson;
+  start?: EventDateTime;
+  end?: EventDateTime;
+  endTimeUnspecified?: boolean;
+  recurrence?: string[];
+  recurringEventId?: string;
+  originalStartTime?: EventDateTime;
+  transparency?: string;
+  visibility?: string;
+  iCalUID?: string;
+  sequence?: number;
+  attendees?: EventAttendee[];
+  attendeesOmitted?: boolean;
+  hangoutLink?: string;
+  conferenceData?: ConferenceData;
+  reminders?: EventReminders;
+  source?: EventSource;
+  attachments?: EventAttachment[];
+  eventType?: string;
+}
+
+export interface EventPerson {
+  id?: string;
+  email?: string;
+  displayName?: string;
+  self?: boolean;
+}
+
+export interface EventAttendee {
+  id?: string;
+  email?: string;
+  displayName?: string;
+  organizer?: boolean;
+  self?: boolean;
+  resource?: boolean;
+  optional?: boolean;
+  responseStatus?: string;
+  comment?: string;
+  additionalGuests?: number;
+}
+
+export interface ConferenceData {
+  createRequest?: ConferenceRequest;
+  entryPoints?: EntryPoint[];
+  conferenceSolution?: ConferenceSolution;
+  conferenceId?: string;
+  notes?: string;
+}
+
+export interface ConferenceRequest {
+  requestId?: string;
+  conferenceSolutionKey?: ConferenceSolutionKey;
+  status?: ConferenceRequestStatus;
+}
+
+export interface ConferenceSolutionKey {
+  type?: string;
+}
+
+export interface ConferenceRequestStatus {
+  statusCode?: string;
+}
+
+export interface EntryPoint {
+  entryPointType?: string;
+  uri?: string;
+  label?: string;
+  pin?: string;
+  accessCode?: string;
+  meetingCode?: string;
+  passcode?: string;
+  password?: string;
+}
+
+export interface ConferenceSolution {
+  key?: ConferenceSolutionKey;
+  name?: string;
+  iconUri?: string;
+}
+
+export interface EventReminders {
+  useDefault?: boolean;
+  overrides?: ReminderOverride[];
+}
+
+export interface ReminderOverride {
+  method?: string;
+  minutes?: number;
+}
+
+export interface EventSource {
+  url?: string;
+  title?: string;
+}
+
+export interface EventAttachment {
+  fileUrl?: string;
+  title?: string;
+  mimeType?: string;
+  iconLink?: string;
+  fileId?: string;
+}
+
+export interface EventList {
+  kind?: string;
+  etag?: string;
+  summary?: string;
+  description?: string;
+  updated?: string;
+  timeZone?: string;
+  accessRole?: string;
+  defaultReminders?: ReminderOverride[];
+  nextPageToken?: string;
+  nextSyncToken?: string;
+  items?: Event[];
+}
+
+// ========== CalendarList ==========
+
+export interface CalendarListEntry {
+  kind?: string;
+  etag?: string;
+  id?: string;
+  summary?: string;
+  description?: string;
+  location?: string;
+  timeZone?: string;
+  summaryOverride?: string;
+  colorId?: string;
+  backgroundColor?: string;
+  foregroundColor?: string;
+  hidden?: boolean;
+  selected?: boolean;
+  accessRole?: string;
+  defaultReminders?: ReminderOverride[];
+  notificationSettings?: NotificationSettings;
+  primary?: boolean;
+  deleted?: boolean;
+  conferenceProperties?: ConferenceProperties;
+}
+
+export interface NotificationSettings {
+  notifications?: NotificationSetting[];
+}
+
+export interface NotificationSetting {
+  type?: string;
+  method?: string;
+}
+
+export interface ConferenceProperties {
+  allowedConferenceSolutionTypes?: string[];
+}
+
+export interface CalendarListList {
+  kind?: string;
+  etag?: string;
+  nextPageToken?: string;
+  nextSyncToken?: string;
+  items?: CalendarListEntry[];
+}
+
+// ========== Calendar ==========
+
+export interface Calendar {
+  kind?: string;
+  etag?: string;
+  id?: string;
+  summary?: string;
+  description?: string;
+  location?: string;
+  timeZone?: string;
+  conferenceProperties?: ConferenceProperties;
+}
+
+// ========== ACL ==========
+
+export interface AclRule {
+  kind?: string;
+  etag?: string;
+  id?: string;
+  scope?: AclScope;
+  role?: string;
+}
+
+export interface AclScope {
+  type?: string;
+  value?: string;
+}
+
+export interface AclList {
+  kind?: string;
+  etag?: string;
+  nextPageToken?: string;
+  nextSyncToken?: string;
+  items?: AclRule[];
+}
+
+// ========== FreeBusy ==========
+
+export interface FreeBusyRequest {
+  timeMin: string;
+  timeMax: string;
+  timeZone?: string;
+  groupExpansionMax?: number;
+  calendarExpansionMax?: number;
+  items: FreeBusyRequestItem[];
+}
+
+export interface FreeBusyRequestItem {
+  id: string;
+}
+
+export interface FreeBusyResponse {
+  kind?: string;
+  timeMin?: string;
+  timeMax?: string;
+  groups?: Record<string, FreeBusyGroup>;
+  calendars?: Record<string, FreeBusyCalendar>;
+}
+
+export interface FreeBusyGroup {
+  errors?: ErrorEntry[];
+  calendars?: string[];
+}
+
+export interface FreeBusyCalendar {
+  errors?: ErrorEntry[];
+  busy?: TimePeriod[];
+}
+
+export interface ErrorEntry {
+  domain?: string;
+  reason?: string;
+}
+
+export interface TimePeriod {
+  start?: string;
+  end?: string;
+}
+
+// ========== Colors ==========
+
+export interface Colors {
+  kind?: string;
+  updated?: string;
+  calendar?: Record<string, ColorDefinition>;
+  event?: Record<string, ColorDefinition>;
+}
+
+export interface ColorDefinition {
+  background?: string;
+  foreground?: string;
+}
+
+// ========== Settings ==========
+
+export interface Setting {
+  kind?: string;
+  etag?: string;
+  id?: string;
+  value?: string;
+}
+
+export interface SettingsList {
+  kind?: string;
+  etag?: string;
+  nextPageToken?: string;
+  nextSyncToken?: string;
+  items?: Setting[];
+}
+
+// ========== 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: 'google-calendar-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 = "google-calendar-mcp-community"
+main = "src/worker.ts"
+compatibility_date = "2025-01-01"
+workers_dev = true
+
+[[routes]]
+pattern = "google-calendar-mcp-community.node2flow.net"
+custom_domain = true
+
+[placement]
+mode = "smart"
+
+[observability]
+enabled = true