feat(tools): added google calendar tools/block, and gcal selector subblock (#454)

* added google calendar picker, tools, & block

* added attendees list to quick add for gcal

* added docs for gcal

* cleanup

* consolidated utils, additional type safety

Author: waleedlatif1

apps/docs/content/docs/tools/google_calendar.mdx

@@ -0,0 +1,207 @@
+---
+title: Google Calendar
+description: Manage Google Calendar events
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="google_calendar"
+  color="#E0E0E0"
+  icon={true}
+  iconSvg={`<svg className="block-icon"
+      
+      version='1.1'
+      xmlns='http://www.w3.org/2000/svg'
+      xmlnsXlink='http://www.w3.org/1999/xlink'
+      x='0px'
+      y='0px'
+      viewBox='0 0 200 200'
+      enableBackground='new 0 0 200 200'
+      xmlSpace='preserve'
+    >
+      <g>
+        <g transform='translate(3.75 3.75)'>
+          <path
+            fill='#FFFFFF'
+            d='M148.882,43.618l-47.368-5.263l-57.895,5.263L38.355,96.25l5.263,52.632l52.632,6.579l52.632-6.579
+			l5.263-53.947L148.882,43.618z'
+          />
+          <path
+            fill='#1A73E8'
+            d='M65.211,125.276c-3.934-2.658-6.658-6.539-8.145-11.671l9.132-3.763c0.829,3.158,2.276,5.605,4.342,7.342
+			c2.053,1.737,4.553,2.592,7.474,2.592c2.987,0,5.553-0.908,7.697-2.724s3.224-4.132,3.224-6.934c0-2.868-1.132-5.211-3.395-7.026
+			s-5.105-2.724-8.5-2.724h-5.276v-9.039H76.5c2.921,0,5.382-0.789,7.382-2.368c2-1.579,3-3.737,3-6.487
+			c0-2.447-0.895-4.395-2.684-5.855s-4.053-2.197-6.803-2.197c-2.684,0-4.816,0.711-6.395,2.145s-2.724,3.197-3.447,5.276
+			l-9.039-3.763c1.197-3.395,3.395-6.395,6.618-8.987c3.224-2.592,7.342-3.895,12.342-3.895c3.697,0,7.026,0.711,9.974,2.145
+			c2.947,1.434,5.263,3.421,6.934,5.947c1.671,2.539,2.5,5.382,2.5,8.539c0,3.224-0.776,5.947-2.329,8.184
+			c-1.553,2.237-3.461,3.947-5.724,5.145v0.539c2.987,1.25,5.421,3.158,7.342,5.724c1.908,2.566,2.868,5.632,2.868,9.211
+			s-0.908,6.776-2.724,9.579c-1.816,2.803-4.329,5.013-7.513,6.618c-3.197,1.605-6.789,2.421-10.776,2.421
+			C73.408,129.263,69.145,127.934,65.211,125.276z'
+          />
+          <path
+            fill='#1A73E8'
+            d='M121.25,79.961l-9.974,7.25l-5.013-7.605l17.987-12.974h6.895v61.197h-9.895L121.25,79.961z'
+          />
+          <path
+            fill='#EA4335'
+            d='M148.882,196.25l47.368-47.368l-23.684-10.526l-23.684,10.526l-10.526,23.684L148.882,196.25z'
+          />
+          <path
+            fill='#34A853'
+            d='M33.092,172.566l10.526,23.684h105.263v-47.368H43.618L33.092,172.566z'
+          />
+          <path
+            fill='#4285F4'
+            d='M12.039-3.75C3.316-3.75-3.75,3.316-3.75,12.039v136.842l23.684,10.526l23.684-10.526V43.618h105.263
+			l10.526-23.684L148.882-3.75H12.039z'
+          />
+          <path
+            fill='#188038'
+            d='M-3.75,148.882v31.579c0,8.724,7.066,15.789,15.789,15.789h31.579v-47.368H-3.75z'
+          />
+          <path
+            fill='#FBBC04'
+            d='M148.882,43.618v105.263h47.368V43.618l-23.684-10.526L148.882,43.618z'
+          />
+          <path
+            fill='#1967D2'
+            d='M196.25,43.618V12.039c0-8.724-7.066-15.789-15.789-15.789h-31.579v47.368H196.25z'
+          />
+        </g>
+      </g>
+    </svg>`}
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+[Google Calendar](https://calendar.google.com) is Google's powerful calendar and scheduling service that provides a comprehensive platform for managing events, meetings, and appointments. With seamless integration across Google's ecosystem and widespread adoption, Google Calendar offers robust features for both personal and professional scheduling needs.
+
+With Google Calendar, you can:
+
+- **Create and manage events**: Schedule meetings, appointments, and reminders with detailed information
+- **Send calendar invites**: Automatically notify and coordinate with attendees through email invitations
+- **Natural language event creation**: Quickly add events using conversational language like "Meeting with John tomorrow at 3pm"
+- **View and search events**: Easily find and access your scheduled events across multiple calendars
+- **Manage multiple calendars**: Organize different types of events across various calendars
+
+In Sim Studio, the Google Calendar integration enables your agents to programmatically create, read, and manage calendar events. This allows for powerful automation scenarios such as scheduling meetings, sending calendar invites, checking availability, and managing event details. Your agents can create events with natural language input, send automated calendar invitations to attendees, retrieve event information, and list upcoming events. This integration bridges the gap between your AI workflows and calendar management, enabling seamless scheduling automation and coordination with one of the world's most widely used calendar platforms.
+{/* MANUAL-CONTENT-END */}
+
+
+## Usage Instructions
+
+Integrate Google Calendar functionality to create, read, update, and list calendar events within your workflow. Automate scheduling, check availability, and manage events using OAuth authentication.
+
+
+
+## Tools
+
+### `google_calendar_create`
+
+Create a new event in Google Calendar
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `accessToken` | string | Yes | Access token for Google Calendar API |
+| `calendarId` | string | No | Calendar ID \(defaults to primary\) |
+| `summary` | string | Yes | Event title/summary |
+| `description` | string | No | Event description |
+| `location` | string | No | Event location |
+| `startDateTime` | string | Yes | Start date and time \(RFC3339 format, e.g., 2025-06-03T10:00:00-08:00\) |
+| `endDateTime` | string | Yes | End date and time \(RFC3339 format, e.g., 2025-06-03T11:00:00-08:00\) |
+| `timeZone` | string | No | Time zone \(e.g., America/Los_Angeles\) |
+| `attendees` | array | No | Array of attendee email addresses |
+| `sendUpdates` | string | No | How to send updates to attendees: all, externalOnly, or none |
+
+#### Output
+
+| Parameter | Type |
+| --------- | ---- |
+| `content` | string |
+
+### `google_calendar_list`
+
+List events from Google Calendar
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `accessToken` | string | Yes | Access token for Google Calendar API |
+| `calendarId` | string | No | Calendar ID \(defaults to primary\) |
+| `timeMin` | string | No | Lower bound for events \(RFC3339 timestamp, e.g., 2025-06-03T00:00:00Z\) |
+| `timeMax` | string | No | Upper bound for events \(RFC3339 timestamp, e.g., 2025-06-04T00:00:00Z\) |
+| `orderBy` | string | No | Order of events returned \(startTime or updated\) |
+| `showDeleted` | boolean | No | Include deleted events |
+
+#### Output
+
+| Parameter | Type |
+| --------- | ---- |
+| `content` | string |
+
+### `google_calendar_get`
+
+Get a specific event from Google Calendar
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `accessToken` | string | Yes | Access token for Google Calendar API |
+| `calendarId` | string | No | Calendar ID \(defaults to primary\) |
+| `eventId` | string | Yes | Event ID to retrieve |
+
+#### Output
+
+| Parameter | Type |
+| --------- | ---- |
+| `content` | string |
+
+### `google_calendar_quick_add`
+
+Create events from natural language text
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `accessToken` | string | Yes | Access token for Google Calendar API |
+| `calendarId` | string | No | Calendar ID \(defaults to primary\) |
+| `text` | string | Yes | Natural language text describing the event \(e.g.,  |
+| `attendees` | array | No | Array of attendee email addresses \(comma-separated string also accepted\) |
+| `sendUpdates` | string | No | How to send updates to attendees: all, externalOnly, or none |
+
+#### Output
+
+| Parameter | Type |
+| --------- | ---- |
+| `content` | string |
+
+
+
+## Block Configuration
+
+### Input
+
+| Parameter | Type | Required | Description | 
+| --------- | ---- | -------- | ----------- | 
+| `operation` | string | Yes | Operation |
+
+
+
+### Outputs
+
+| Output | Type | Description |
+| ------ | ---- | ----------- |
+| `response` | object | Output from response |
+| ↳ `content` | string | content of the response |
+| ↳ `metadata` | json | metadata of the response |
+
+
+## Notes
+
+- Category: `tools`
+- Type: `google_calendar`

apps/docs/content/docs/tools/knowledge.mdx

@@ -46,6 +46,7 @@ Key features of the Knowledge Base include:
 In Sim Studio, the Knowledge Base block enables your agents to perform intelligent semantic searches across your custom knowledge bases. This creates opportunities for automated information retrieval, content recommendations, and knowledge discovery as part of your AI workflows. The integration allows agents to search and retrieve relevant information programmatically, facilitating automated knowledge management tasks and ensuring that important information is easily accessible. By leveraging the Knowledge Base block, you can build intelligent agents that enhance information discovery while automating routine knowledge management tasks, improving team efficiency and ensuring consistent access to organizational knowledge.
 {/* MANUAL-CONTENT-END */}
 
+
 ## Usage Instructions
 
 Perform semantic vector search across your knowledge base to find the most relevant content. Uses advanced AI embeddings to understand meaning and context, returning the most similar documents to your search query.

apps/docs/content/docs/tools/meta.json

@@ -13,6 +13,7 @@
     "firecrawl",
     "github",
     "gmail",
+    "google_calendar",
     "google_docs",
     "google_drive",
     "google_search",

apps/sim/app/api/tools/google_calendar/calendars/route.ts

@@ -0,0 +1,130 @@
+import { eq } from 'drizzle-orm'
+import { type NextRequest, NextResponse } from 'next/server'
+import { getSession } from '@/lib/auth'
+import { createLogger } from '@/lib/logs/console-logger'
+import { refreshAccessTokenIfNeeded } from '@/app/api/auth/oauth/utils'
+import { db } from '@/db'
+import { account } from '@/db/schema'
+
+export const dynamic = 'force-dynamic'
+
+const logger = createLogger('GoogleCalendarAPI')
+
+interface CalendarListItem {
+  id: string
+  summary: string
+  description?: string
+  primary?: boolean
+  accessRole: string
+  backgroundColor?: string
+  foregroundColor?: string
+}
+
+/**
+ * Get calendars from Google Calendar
+ */
+export async function GET(request: NextRequest) {
+  const requestId = crypto.randomUUID().slice(0, 8) // Generate a short request ID for correlation
+  logger.info(`[${requestId}] Google Calendar calendars request received`)
+
+  try {
+    // Get the session
+    const session = await getSession()
+
+    // Check if the user is authenticated
+    if (!session?.user?.id) {
+      logger.warn(`[${requestId}] Unauthenticated request rejected`)
+      return NextResponse.json({ error: 'User not authenticated' }, { status: 401 })
+    }
+
+    // Get the credential ID from the query params
+    const { searchParams } = new URL(request.url)
+    const credentialId = searchParams.get('credentialId')
+
+    if (!credentialId) {
+      logger.warn(`[${requestId}] Missing credentialId parameter`)
+      return NextResponse.json({ error: 'Credential ID is required' }, { status: 400 })
+    }
+
+    // Get the credential from the database
+    const credentials = await db.select().from(account).where(eq(account.id, credentialId)).limit(1)
+
+    if (!credentials.length) {
+      logger.warn(`[${requestId}] Credential not found`, { credentialId })
+      return NextResponse.json({ error: 'Credential not found' }, { status: 404 })
+    }
+
+    const credential = credentials[0]
+
+    // Check if the credential belongs to the user
+    if (credential.userId !== session.user.id) {
+      logger.warn(`[${requestId}] Unauthorized credential access attempt`, {
+        credentialUserId: credential.userId,
+        requestUserId: session.user.id,
+      })
+      return NextResponse.json({ error: 'Unauthorized' }, { status: 403 })
+    }
+
+    // Refresh access token if needed using the utility function
+    const accessToken = await refreshAccessTokenIfNeeded(credentialId, session.user.id, requestId)
+
+    if (!accessToken) {
+      return NextResponse.json({ error: 'Failed to obtain valid access token' }, { status: 401 })
+    }
+
+    // Fetch calendars from Google Calendar API
+    logger.info(`[${requestId}] Fetching calendars from Google Calendar API`)
+    const calendarResponse = await fetch(
+      'https://www.googleapis.com/calendar/v3/users/me/calendarList',
+      {
+        method: 'GET',
+        headers: {
+          Authorization: `Bearer ${accessToken}`,
+          'Content-Type': 'application/json',
+        },
+      }
+    )
+
+    if (!calendarResponse.ok) {
+      const errorData = await calendarResponse
+        .text()
+        .then((text) => JSON.parse(text))
+        .catch(() => ({ error: { message: 'Unknown error' } }))
+      logger.error(`[${requestId}] Google Calendar API error`, {
+        status: calendarResponse.status,
+        error: errorData.error?.message || 'Failed to fetch calendars',
+      })
+      return NextResponse.json(
+        { error: errorData.error?.message || 'Failed to fetch calendars' },
+        { status: calendarResponse.status }
+      )
+    }
+
+    const data = await calendarResponse.json()
+    const calendars: CalendarListItem[] = data.items || []
+
+    // Sort calendars with primary first, then alphabetically
+    calendars.sort((a, b) => {
+      if (a.primary && !b.primary) return -1
+      if (!a.primary && b.primary) return 1
+      return a.summary.localeCompare(b.summary)
+    })
+
+    logger.info(`[${requestId}] Successfully fetched ${calendars.length} calendars`)
+
+    return NextResponse.json({
+      calendars: calendars.map((calendar) => ({
+        id: calendar.id,
+        summary: calendar.summary,
+        description: calendar.description,
+        primary: calendar.primary || false,
+        accessRole: calendar.accessRole,
+        backgroundColor: calendar.backgroundColor,
+        foregroundColor: calendar.foregroundColor,
+      })),
+    })
+  } catch (error) {
+    logger.error(`[${requestId}] Error fetching Google calendars`, error)
+    return NextResponse.json({ error: 'Internal server error' }, { status: 500 })
+  }
+}