@jezweb/mcp-integrations 0.1.1

package/README.md

@@ -0,0 +1,78 @@
+# @jezweb/mcp-integrations
+
+Reusable MCP tools, resources, and prompts for backend service integrations.
+
+## Installation
+
+```bash
+npm install @jezweb/mcp-integrations
+```
+
+## Usage
+
+```typescript
+import { tools, resources, prompts } from '@jezweb/mcp-integrations/google/calendar';
+
+// Register calendar tools with your MCP server
+tools.all.forEach(tool => {
+  server.tool(tool.name, tool.description, tool.parameters,
+    (params) => tool.handler(params, { authorizedFetch })
+  );
+});
+```
+
+## Available Integrations
+
+| Integration | Import Path | Tools | Status |
+|-------------|-------------|-------|--------|
+| Google Calendar | `@jezweb/mcp-integrations/google/calendar` | 5 | ✅ Ready |
+| Google Gmail | `@jezweb/mcp-integrations/google/gmail` | - | 🔜 Planned |
+| Google Sheets | `@jezweb/mcp-integrations/google/sheets` | - | 🔜 Planned |
+| Xero | `@jezweb/mcp-integrations/xero` | - | 🔜 Planned |
+
+## Tool Presets
+
+Each integration exports tool presets for different access levels:
+
+```typescript
+import { tools } from '@jezweb/mcp-integrations/google/calendar';
+
+tools.all;           // All tools
+tools.readOnly;      // List operations only
+tools.fullAccess;    // All CRUD operations
+tools.alwaysVisible; // Core tools (for Tool Search)
+```
+
+## Tool Search Support
+
+All tools include metadata for Anthropic's Tool Search pattern:
+
+- `category`: Logical grouping (e.g., "calendar", "email")
+- `tags`: Searchable keywords
+- `alwaysVisible`: Whether tool is always shown or discoverable via search
+
+## ToolContext
+
+Tools receive a `ToolContext` with:
+
+```typescript
+interface ToolContext {
+  authorizedFetch: (url: string, init?: RequestInit) => Promise<Response>;
+  userId?: string;
+  userEmail?: string;
+}
+```
+
+Your MCP server provides `authorizedFetch` with OAuth token handling.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run dev  # Watch mode
+```
+
+## License
+
+MIT

package/dist/google/calendar/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Google Calendar Integration
+ *
+ * @example
+ * ```typescript
+ * import { tools, resources, prompts } from '@jezweb/mcp-integrations/google/calendar';
+ *
+ * // Register all calendar tools
+ * tools.all.forEach(tool => {
+ *   server.tool(tool.name, tool.description, tool.parameters,
+ *     (params) => tool.handler(params, ctx)
+ *   );
+ * });
+ *
+ * // Or use selective presets
+ * tools.readOnly.forEach(tool => { ... });  // Just listEvents
+ * tools.fullAccess.forEach(tool => { ... }); // All CRUD operations
+ * ```
+ */
+export * as tools from './tools';
+export { listCalendars, listEvents, createEvent, updateEvent, deleteEvent, quickAddEvent, } from './tools';
+export * as resources from './resources';
+export { calendarList } from './resources';
+export * as prompts from './prompts';
+export { scheduleAssistant, dailyAgenda } from './prompts';
+export { all as allTools, alwaysVisible, readOnly, fullAccess } from './tools';
+export { all as allResources } from './resources';
+export { all as allPrompts } from './prompts';
+//# sourceMappingURL=index.d.ts.map

package/dist/google/calendar/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/google/calendar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG3D,OAAO,EAAE,GAAG,IAAI,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,GAAG,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,GAAG,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/google/calendar/index.js

@@ -0,0 +1,33 @@
+/**
+ * Google Calendar Integration
+ *
+ * @example
+ * ```typescript
+ * import { tools, resources, prompts } from '@jezweb/mcp-integrations/google/calendar';
+ *
+ * // Register all calendar tools
+ * tools.all.forEach(tool => {
+ *   server.tool(tool.name, tool.description, tool.parameters,
+ *     (params) => tool.handler(params, ctx)
+ *   );
+ * });
+ *
+ * // Or use selective presets
+ * tools.readOnly.forEach(tool => { ... });  // Just listEvents
+ * tools.fullAccess.forEach(tool => { ... }); // All CRUD operations
+ * ```
+ */
+// Tools
+export * as tools from './tools';
+export { listCalendars, listEvents, createEvent, updateEvent, deleteEvent, quickAddEvent, } from './tools';
+// Resources
+export * as resources from './resources';
+export { calendarList } from './resources';
+// Prompts
+export * as prompts from './prompts';
+export { scheduleAssistant, dailyAgenda } from './prompts';
+// Re-export presets for convenience
+export { all as allTools, alwaysVisible, readOnly, fullAccess } from './tools';
+export { all as allResources } from './resources';
+export { all as allPrompts } from './prompts';
+//# sourceMappingURL=index.js.map

package/dist/google/calendar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/google/calendar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,QAAQ;AACR,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,YAAY;AACZ,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,UAAU;AACV,OAAO,KAAK,OAAO,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE3D,oCAAoC;AACpC,OAAO,EAAE,GAAG,IAAI,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC/E,OAAO,EAAE,GAAG,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,GAAG,IAAI,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/google/calendar/prompts.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Google Calendar Prompts
+ */
+import { z } from 'zod';
+/**
+ * Schedule assistant prompt
+ */
+export declare const scheduleAssistant: import("../..").PromptDefinition<z.ZodObject<{
+    topic: z.ZodString;
+    duration: z.ZodDefault<z.ZodString>;
+    attendees: z.ZodOptional<z.ZodString>;
+    preferredTime: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+    duration: string;
+    attendees?: string | undefined;
+    preferredTime?: string | undefined;
+}, {
+    topic: string;
+    attendees?: string | undefined;
+    duration?: string | undefined;
+    preferredTime?: string | undefined;
+}>>;
+/**
+ * Daily agenda prompt
+ */
+export declare const dailyAgenda: import("../..").PromptDefinition<z.ZodObject<{
+    date: z.ZodOptional<z.ZodString>;
+    includePrep: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    includePrep: boolean;
+    date?: string | undefined;
+}, {
+    date?: string | undefined;
+    includePrep?: boolean | undefined;
+}>>;
+/**
+ * All calendar prompts
+ */
+export declare const all: (import("../..").PromptDefinition<z.ZodObject<{
+    topic: z.ZodString;
+    duration: z.ZodDefault<z.ZodString>;
+    attendees: z.ZodOptional<z.ZodString>;
+    preferredTime: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+    duration: string;
+    attendees?: string | undefined;
+    preferredTime?: string | undefined;
+}, {
+    topic: string;
+    attendees?: string | undefined;
+    duration?: string | undefined;
+    preferredTime?: string | undefined;
+}>> | import("../..").PromptDefinition<z.ZodObject<{
+    date: z.ZodOptional<z.ZodString>;
+    includePrep: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    includePrep: boolean;
+    date?: string | undefined;
+}, {
+    date?: string | undefined;
+    includePrep?: boolean | undefined;
+}>>)[];
+//# sourceMappingURL=prompts.d.ts.map

package/dist/google/calendar/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/google/calendar/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;GA0C5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;GAgCtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;MAAmC,CAAC"}

package/dist/google/calendar/prompts.js

@@ -0,0 +1,88 @@
+/**
+ * Google Calendar Prompts
+ */
+import { z } from 'zod';
+import { definePrompt } from '../../helpers';
+/**
+ * Schedule assistant prompt
+ */
+export const scheduleAssistant = definePrompt({
+    name: 'schedule_meeting',
+    description: 'Help schedule a meeting by finding available times and creating the event',
+    category: 'calendar',
+    tags: ['google', 'calendar', 'schedule', 'meeting', 'assistant'],
+    arguments: z.object({
+        topic: z.string().describe('Meeting topic or purpose'),
+        duration: z
+            .string()
+            .default('30 minutes')
+            .describe('Meeting duration (e.g., "30 minutes", "1 hour")'),
+        attendees: z
+            .string()
+            .optional()
+            .describe('Comma-separated list of attendee emails'),
+        preferredTime: z
+            .string()
+            .optional()
+            .describe('Preferred time of day (e.g., "morning", "afternoon", "2pm")'),
+    }),
+    handler: async (args) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Help me schedule a meeting about "${args.topic}".
+
+Duration: ${args.duration}
+${args.attendees ? `Attendees: ${args.attendees}` : ''}
+${args.preferredTime ? `Preferred time: ${args.preferredTime}` : ''}
+
+Please:
+1. Check my calendar for available slots in the next few days
+2. Suggest 2-3 good times for this meeting
+3. Once I pick a time, create the event with appropriate details`,
+                },
+            },
+        ],
+    }),
+});
+/**
+ * Daily agenda prompt
+ */
+export const dailyAgenda = definePrompt({
+    name: 'daily_agenda',
+    description: 'Get a summary of today\'s calendar events with preparation notes',
+    category: 'calendar',
+    tags: ['google', 'calendar', 'agenda', 'daily', 'summary'],
+    arguments: z.object({
+        date: z
+            .string()
+            .optional()
+            .describe('Date to check (YYYY-MM-DD, default: today)'),
+        includePrep: z
+            .boolean()
+            .default(true)
+            .describe('Include preparation notes for meetings'),
+    }),
+    handler: async (args) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Show me my agenda for ${args.date || 'today'}.
+
+${args.includePrep ? 'For each meeting, please include:\n- Brief preparation notes\n- Key topics to cover\n- Any action items from previous meetings if relevant' : ''}
+
+Format it as a clear timeline I can follow throughout the day.`,
+                },
+            },
+        ],
+    }),
+});
+/**
+ * All calendar prompts
+ */
+export const all = [scheduleAssistant, dailyAgenda];
+//# sourceMappingURL=prompts.js.map

package/dist/google/calendar/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/google/calendar/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;IAC5C,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,2EAA2E;IACxF,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC;IAEhE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACtD,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,OAAO,CAAC,YAAY,CAAC;aACrB,QAAQ,CAAC,iDAAiD,CAAC;QAC9D,SAAS,EAAE,CAAC;aACT,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,yCAAyC,CAAC;QACtD,aAAa,EAAE,CAAC;aACb,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,6DAA6D,CAAC;KAC3E,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACxB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,qCAAqC,IAAI,CAAC,KAAK;;YAEnD,IAAI,CAAC,QAAQ;EACvB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;EACpD,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;iEAKF;iBACxD;aACF;SACF;KACF,CAAC;CACH,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;IACtC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,kEAAkE;IAC/E,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;IAE1D,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4CAA4C,CAAC;QACzD,WAAW,EAAE,CAAC;aACX,OAAO,EAAE;aACT,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CAAC,wCAAwC,CAAC;KACtD,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACxB,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,yBAAyB,IAAI,CAAC,IAAI,IAAI,OAAO;;EAE3D,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,4IAA4I,CAAC,CAAC,CAAC,EAAE;;+DAEvG;iBACtD;aACF;SACF;KACF,CAAC;CACH,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC"}

package/dist/google/calendar/resources.d.ts

@@ -0,0 +1,9 @@
+/**
+ * List of user's calendars
+ */
+export declare const calendarList: import("../..").ResourceDefinition;
+/**
+ * All calendar resources
+ */
+export declare const all: import("../..").ResourceDefinition[];
+//# sourceMappingURL=resources.d.ts.map

package/dist/google/calendar/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/google/calendar/resources.ts"],"names":[],"mappings":"AAsBA;;GAEG;AACH,eAAO,MAAM,YAAY,oCA+CvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,GAAG,sCAAiB,CAAC"}

package/dist/google/calendar/resources.js

@@ -0,0 +1,56 @@
+/**
+ * Google Calendar Resources
+ */
+import { defineResource } from '../../helpers';
+const CALENDAR_API = 'https://www.googleapis.com/calendar/v3';
+/**
+ * List of user's calendars
+ */
+export const calendarList = defineResource({
+    name: 'google_calendar_list',
+    uri: 'mcp://google/calendar/list',
+    metadata: {
+        description: "List of user's Google calendars with IDs and access roles",
+        mimeType: 'application/json',
+    },
+    category: 'calendar',
+    tags: ['google', 'calendar', 'list', 'calendars'],
+    handler: async (uri, ctx) => {
+        const response = await ctx.authorizedFetch(`${CALENDAR_API}/users/me/calendarList`);
+        if (!response.ok) {
+            const error = await response.text();
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: 'application/json',
+                        text: JSON.stringify({ error: `Failed to fetch calendars: ${error}` }),
+                    },
+                ],
+            };
+        }
+        const data = (await response.json());
+        const calendars = data.items?.map((c) => ({
+            id: c.id,
+            name: c.summary,
+            description: c.description,
+            primary: c.primary || false,
+            accessRole: c.accessRole,
+            timeZone: c.timeZone,
+        })) || [];
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(calendars, null, 2),
+                },
+            ],
+        };
+    },
+});
+/**
+ * All calendar resources
+ */
+export const all = [calendarList];
+//# sourceMappingURL=resources.js.map

package/dist/google/calendar/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../../../src/google/calendar/resources.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,MAAM,YAAY,GAAG,wCAAwC,CAAC;AAgB9D;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;IACzC,IAAI,EAAE,sBAAsB;IAC5B,GAAG,EAAE,4BAA4B;IACjC,QAAQ,EAAE;QACR,WAAW,EAAE,2DAA2D;QACxE,QAAQ,EAAE,kBAAkB;KAC7B;IACD,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC;IAEjD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAgB,EAAE,EAAE;QACvC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,GAAG,YAAY,wBAAwB,CAAC,CAAC;QAEpF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,8BAA8B,KAAK,EAAE,EAAE,CAAC;qBACvE;iBACF;aACF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;QAC7D,MAAM,SAAS,GACb,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,OAAO;YACf,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK;YAC3B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,IAAI,EAAE,CAAC;QAEZ,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;iBACzC;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC"}

package/dist/google/calendar/tools/calendars.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Google Calendar List Tools
+ */
+import { z } from 'zod';
+/**
+ * List all calendars the user has access to
+ *
+ * This is essential for:
+ * - Discovering shared calendars (team calendars, meeting rooms)
+ * - Finding the correct calendarId for operations
+ * - Understanding access roles (owner, writer, reader)
+ */
+export declare const listCalendars: import("../../..").ToolDefinition<z.ZodObject<{
+    showHidden: z.ZodDefault<z.ZodBoolean>;
+    showDeleted: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    showHidden: boolean;
+    showDeleted: boolean;
+}, {
+    showHidden?: boolean | undefined;
+    showDeleted?: boolean | undefined;
+}>>;
+/**
+ * All calendar list tools
+ */
+export declare const all: import("../../..").ToolDefinition<z.ZodObject<{
+    showHidden: z.ZodDefault<z.ZodBoolean>;
+    showDeleted: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    showHidden: boolean;
+    showDeleted: boolean;
+}, {
+    showHidden?: boolean | undefined;
+    showDeleted?: boolean | undefined;
+}>>[];
+//# sourceMappingURL=calendars.d.ts.map

package/dist/google/calendar/tools/calendars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendars.d.ts","sourceRoot":"","sources":["../../../../src/google/calendar/tools/calendars.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwBxB;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;;;;GAkExB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;KAAkB,CAAC"}

package/dist/google/calendar/tools/calendars.js

@@ -0,0 +1,77 @@
+/**
+ * Google Calendar List Tools
+ */
+import { z } from 'zod';
+import { defineTool, jsonResult, errorResult } from '../../../helpers';
+const CALENDAR_API = 'https://www.googleapis.com/calendar/v3';
+/**
+ * List all calendars the user has access to
+ *
+ * This is essential for:
+ * - Discovering shared calendars (team calendars, meeting rooms)
+ * - Finding the correct calendarId for operations
+ * - Understanding access roles (owner, writer, reader)
+ */
+export const listCalendars = defineTool({
+    name: 'google_calendar_list_calendars',
+    description: 'List all calendars the user has access to, including shared and subscribed calendars. Returns calendar IDs needed for other operations.',
+    category: 'calendar',
+    tags: ['google', 'calendar', 'list', 'discover', 'shared', 'read'],
+    alwaysVisible: true,
+    parameters: z.object({
+        showHidden: z
+            .boolean()
+            .default(false)
+            .describe('Whether to show hidden calendars'),
+        showDeleted: z
+            .boolean()
+            .default(false)
+            .describe('Whether to show deleted calendars'),
+    }),
+    handler: async (params, ctx) => {
+        const url = new URL(`${CALENDAR_API}/users/me/calendarList`);
+        if (params.showHidden) {
+            url.searchParams.set('showHidden', 'true');
+        }
+        if (params.showDeleted) {
+            url.searchParams.set('showDeleted', 'true');
+        }
+        const response = await ctx.authorizedFetch(url.toString());
+        if (!response.ok) {
+            const error = await response.text();
+            return errorResult(`Calendar API error: ${response.status} - ${error}`);
+        }
+        const data = (await response.json());
+        const calendars = data.items || [];
+        if (calendars.length === 0) {
+            return { content: [{ type: 'text', text: 'No calendars found.' }] };
+        }
+        // Sort: primary first, then by name
+        const sorted = calendars.sort((a, b) => {
+            if (a.primary && !b.primary)
+                return -1;
+            if (!a.primary && b.primary)
+                return 1;
+            return (a.summary || '').localeCompare(b.summary || '');
+        });
+        const formatted = sorted.map((c) => ({
+            id: c.id,
+            name: c.summary,
+            description: c.description,
+            primary: c.primary || false,
+            accessRole: c.accessRole,
+            timeZone: c.timeZone,
+            color: c.backgroundColor,
+        }));
+        return jsonResult({
+            count: formatted.length,
+            calendars: formatted,
+            hint: 'Use the calendar "id" as the calendarId parameter in other tools. The "primary" calendar is your main calendar.',
+        });
+    },
+});
+/**
+ * All calendar list tools
+ */
+export const all = [listCalendars];
+//# sourceMappingURL=calendars.js.map

package/dist/google/calendar/tools/calendars.js.map

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

package/dist/google/calendar/tools/events.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Google Calendar Event Tools
+ */
+import { z } from 'zod';
+/**
+ * List events from Google Calendar
+ */
+export declare const listEvents: import("../../..").ToolDefinition<z.ZodObject<{
+    calendarId: z.ZodDefault<z.ZodString>;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+    timeMin: z.ZodOptional<z.ZodString>;
+    timeMax: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    calendarId: string;
+    maxResults: number;
+    timeMin?: string | undefined;
+    timeMax?: string | undefined;
+    query?: string | undefined;
+}, {
+    calendarId?: string | undefined;
+    maxResults?: number | undefined;
+    timeMin?: string | undefined;
+    timeMax?: string | undefined;
+    query?: string | undefined;
+}>>;
+/**
+ * Create a new calendar event
+ */
+export declare const createEvent: import("../../..").ToolDefinition<z.ZodObject<{
+    calendarId: z.ZodDefault<z.ZodString>;
+    summary: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodString>;
+    start: z.ZodString;
+    end: z.ZodString;
+    attendees: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    timeZone: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    calendarId: string;
+    summary: string;
+    start: string;
+    end: string;
+    timeZone: string;
+    description?: string | undefined;
+    location?: string | undefined;
+    attendees?: string[] | undefined;
+}, {
+    summary: string;
+    start: string;
+    end: string;
+    calendarId?: string | undefined;
+    description?: string | undefined;
+    location?: string | undefined;
+    attendees?: string[] | undefined;
+    timeZone?: string | undefined;
+}>>;
+/**
+ * Update an existing calendar event
+ */
+export declare const updateEvent: import("../../..").ToolDefinition<z.ZodObject<{
+    calendarId: z.ZodDefault<z.ZodString>;
+    eventId: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    location: z.ZodOptional<z.ZodString>;
+    start: z.ZodOptional<z.ZodString>;
+    end: z.ZodOptional<z.ZodString>;
+    timeZone: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    calendarId: string;
+    timeZone: string;
+    eventId: string;
+    summary?: string | undefined;
+    description?: string | undefined;
+    location?: string | undefined;
+    start?: string | undefined;
+    end?: string | undefined;
+}, {
+    eventId: string;
+    calendarId?: string | undefined;
+    summary?: string | undefined;
+    description?: string | undefined;
+    location?: string | undefined;
+    start?: string | undefined;
+    end?: string | undefined;
+    timeZone?: string | undefined;
+}>>;
+/**
+ * Delete a calendar event
+ */
+export declare const deleteEvent: import("../../..").ToolDefinition<z.ZodObject<{
+    calendarId: z.ZodDefault<z.ZodString>;
+    eventId: z.ZodString;
+    sendUpdates: z.ZodDefault<z.ZodEnum<["all", "externalOnly", "none"]>>;
+}, "strip", z.ZodTypeAny, {
+    calendarId: string;
+    eventId: string;
+    sendUpdates: "all" | "externalOnly" | "none";
+}, {
+    eventId: string;
+    calendarId?: string | undefined;
+    sendUpdates?: "all" | "externalOnly" | "none" | undefined;
+}>>;
+/**
+ * Quick add an event using natural language
+ */
+export declare const quickAddEvent: import("../../..").ToolDefinition<z.ZodObject<{
+    calendarId: z.ZodDefault<z.ZodString>;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    calendarId: string;
+}, {
+    text: string;
+    calendarId?: string | undefined;
+}>>;
+//# sourceMappingURL=events.d.ts.map

package/dist/google/calendar/tools/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/google/calendar/tools/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA+BxB;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;GAwErB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;GAmCtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;GAwCxB,CAAC"}