diff --git a/packages/backend/src/apps/google-calendar/assets/favicon.svg b/packages/backend/src/apps/google-calendar/assets/favicon.svg
new file mode 100644
index 00000000..14b505ab
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/assets/favicon.svg
@@ -0,0 +1,27 @@
+
+
diff --git a/packages/backend/src/apps/google-calendar/auth/generate-auth-url.ts b/packages/backend/src/apps/google-calendar/auth/generate-auth-url.ts
new file mode 100644
index 00000000..ea89f8a4
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/auth/generate-auth-url.ts
@@ -0,0 +1,24 @@
+import { IField, IGlobalVariable } from '@automatisch/types';
+import { URLSearchParams } from 'url';
+import authScope from '../common/auth-scope';
+
+export default async function generateAuthUrl($: IGlobalVariable) {
+ const oauthRedirectUrlField = $.app.auth.fields.find(
+ (field: IField) => field.key == 'oAuthRedirectUrl'
+ );
+ const redirectUri = oauthRedirectUrlField.value as string;
+ const searchParams = new URLSearchParams({
+ client_id: $.auth.data.clientId as string,
+ redirect_uri: redirectUri,
+ prompt: 'select_account',
+ scope: authScope.join(' '),
+ response_type: 'code',
+ access_type: 'offline',
+ });
+
+ const url = `https://accounts.google.com/o/oauth2/v2/auth?${searchParams.toString()}`;
+
+ await $.auth.set({
+ url,
+ });
+}
diff --git a/packages/backend/src/apps/google-calendar/auth/index.ts b/packages/backend/src/apps/google-calendar/auth/index.ts
new file mode 100644
index 00000000..80d63f90
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/auth/index.ts
@@ -0,0 +1,48 @@
+import generateAuthUrl from './generate-auth-url';
+import verifyCredentials from './verify-credentials';
+import refreshToken from './refresh-token';
+import isStillVerified from './is-still-verified';
+
+export default {
+ fields: [
+ {
+ key: 'oAuthRedirectUrl',
+ label: 'OAuth Redirect URL',
+ type: 'string' as const,
+ required: true,
+ readOnly: true,
+ value: '{WEB_APP_URL}/app/google-calendar/connections/add',
+ placeholder: null,
+ description:
+ 'When asked to input a redirect URL in Google Cloud, enter the URL above.',
+ clickToCopy: true,
+ },
+ {
+ key: 'clientId',
+ label: 'Client ID',
+ type: 'string' as const,
+ required: true,
+ readOnly: false,
+ value: null,
+ placeholder: null,
+ description: null,
+ clickToCopy: false,
+ },
+ {
+ key: 'clientSecret',
+ label: 'Client Secret',
+ type: 'string' as const,
+ required: true,
+ readOnly: false,
+ value: null,
+ placeholder: null,
+ description: null,
+ clickToCopy: false,
+ },
+ ],
+
+ generateAuthUrl,
+ verifyCredentials,
+ isStillVerified,
+ refreshToken,
+};
diff --git a/packages/backend/src/apps/google-calendar/auth/is-still-verified.ts b/packages/backend/src/apps/google-calendar/auth/is-still-verified.ts
new file mode 100644
index 00000000..c46fa18b
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/auth/is-still-verified.ts
@@ -0,0 +1,9 @@
+import { IGlobalVariable } from '@automatisch/types';
+import getCurrentUser from '../common/get-current-user';
+
+const isStillVerified = async ($: IGlobalVariable) => {
+ const currentUser = await getCurrentUser($);
+ return !!currentUser.resourceName;
+};
+
+export default isStillVerified;
diff --git a/packages/backend/src/apps/google-calendar/auth/refresh-token.ts b/packages/backend/src/apps/google-calendar/auth/refresh-token.ts
new file mode 100644
index 00000000..17d0c4cc
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/auth/refresh-token.ts
@@ -0,0 +1,26 @@
+import { URLSearchParams } from 'node:url';
+import { IGlobalVariable } from '@automatisch/types';
+import authScope from '../common/auth-scope';
+
+const refreshToken = async ($: IGlobalVariable) => {
+ const params = new URLSearchParams({
+ client_id: $.auth.data.clientId as string,
+ client_secret: $.auth.data.clientSecret as string,
+ grant_type: 'refresh_token',
+ refresh_token: $.auth.data.refreshToken as string,
+ });
+
+ const { data } = await $.http.post(
+ 'https://oauth2.googleapis.com/token',
+ params.toString()
+ );
+
+ await $.auth.set({
+ accessToken: data.access_token,
+ expiresIn: data.expires_in,
+ scope: authScope.join(' '),
+ tokenType: data.token_type,
+ });
+};
+
+export default refreshToken;
diff --git a/packages/backend/src/apps/google-calendar/auth/verify-credentials.ts b/packages/backend/src/apps/google-calendar/auth/verify-credentials.ts
new file mode 100644
index 00000000..124e73c1
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/auth/verify-credentials.ts
@@ -0,0 +1,57 @@
+import { IField, IGlobalVariable } from '@automatisch/types';
+import getCurrentUser from '../common/get-current-user';
+
+type TUser = {
+ displayName: string;
+ metadata: {
+ primary: boolean;
+ };
+};
+
+type TEmailAddress = {
+ value: string;
+ metadata: {
+ primary: boolean;
+ };
+};
+
+const verifyCredentials = async ($: IGlobalVariable) => {
+ const oauthRedirectUrlField = $.app.auth.fields.find(
+ (field: IField) => field.key == 'oAuthRedirectUrl'
+ );
+ const redirectUri = oauthRedirectUrlField.value as string;
+ const { data } = await $.http.post(`https://oauth2.googleapis.com/token`, {
+ client_id: $.auth.data.clientId,
+ client_secret: $.auth.data.clientSecret,
+ code: $.auth.data.code,
+ grant_type: 'authorization_code',
+ redirect_uri: redirectUri,
+ });
+
+ await $.auth.set({
+ accessToken: data.access_token,
+ tokenType: data.token_type,
+ });
+
+ const currentUser = await getCurrentUser($);
+
+ const { displayName } = currentUser.names.find(
+ (name: TUser) => name.metadata.primary
+ );
+ const { value: email } = currentUser.emailAddresses.find(
+ (emailAddress: TEmailAddress) => emailAddress.metadata.primary
+ );
+
+ await $.auth.set({
+ clientId: $.auth.data.clientId,
+ clientSecret: $.auth.data.clientSecret,
+ scope: $.auth.data.scope,
+ idToken: data.id_token,
+ expiresIn: data.expires_in,
+ refreshToken: data.refresh_token,
+ resourceName: currentUser.resourceName,
+ screenName: `${displayName} - ${email}`,
+ });
+};
+
+export default verifyCredentials;
diff --git a/packages/backend/src/apps/google-calendar/common/add-auth-header.ts b/packages/backend/src/apps/google-calendar/common/add-auth-header.ts
new file mode 100644
index 00000000..8e7798b8
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/common/add-auth-header.ts
@@ -0,0 +1,11 @@
+import { TBeforeRequest } from '@automatisch/types';
+
+const addAuthHeader: TBeforeRequest = ($, requestConfig) => {
+ if ($.auth.data?.accessToken) {
+ requestConfig.headers.Authorization = `${$.auth.data.tokenType} ${$.auth.data.accessToken}`;
+ }
+
+ return requestConfig;
+};
+
+export default addAuthHeader;
diff --git a/packages/backend/src/apps/google-calendar/common/auth-scope.ts b/packages/backend/src/apps/google-calendar/common/auth-scope.ts
new file mode 100644
index 00000000..e3625b0d
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/common/auth-scope.ts
@@ -0,0 +1,7 @@
+const authScope: string[] = [
+ 'https://www.googleapis.com/auth/calendar',
+ 'https://www.googleapis.com/auth/userinfo.email',
+ 'https://www.googleapis.com/auth/userinfo.profile',
+];
+
+export default authScope;
diff --git a/packages/backend/src/apps/google-calendar/common/get-current-user.ts b/packages/backend/src/apps/google-calendar/common/get-current-user.ts
new file mode 100644
index 00000000..724fe1ac
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/common/get-current-user.ts
@@ -0,0 +1,10 @@
+import { IGlobalVariable } from '@automatisch/types';
+
+const getCurrentUser = async ($: IGlobalVariable) => {
+ const { data: currentUser } = await $.http.get(
+ 'https://people.googleapis.com/v1/people/me?personFields=names,emailAddresses'
+ );
+ return currentUser;
+};
+
+export default getCurrentUser;
diff --git a/packages/backend/src/apps/google-calendar/index.d.ts b/packages/backend/src/apps/google-calendar/index.d.ts
new file mode 100644
index 00000000..e69de29b
diff --git a/packages/backend/src/apps/google-calendar/index.ts b/packages/backend/src/apps/google-calendar/index.ts
new file mode 100644
index 00000000..89bb0234
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/index.ts
@@ -0,0 +1,18 @@
+import defineApp from '../../helpers/define-app';
+import addAuthHeader from './common/add-auth-header';
+import auth from './auth';
+import triggers from './triggers';
+
+export default defineApp({
+ name: 'Google Calendar',
+ key: 'google-calendar',
+ baseUrl: 'https://calendar.google.com',
+ apiBaseUrl: 'https://www.googleapis.com/calendar',
+ iconUrl: '{BASE_URL}/apps/google-calendar/assets/favicon.svg',
+ authDocUrl: 'https://automatisch.io/docs/apps/google-calendar/connection',
+ primaryColor: '448AFF',
+ supportsConnections: true,
+ beforeRequest: [addAuthHeader],
+ auth,
+ triggers,
+});
diff --git a/packages/backend/src/apps/google-calendar/triggers/index.ts b/packages/backend/src/apps/google-calendar/triggers/index.ts
new file mode 100644
index 00000000..c059efef
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/triggers/index.ts
@@ -0,0 +1,3 @@
+import newCalendar from './new-calendar';
+
+export default [newCalendar];
diff --git a/packages/backend/src/apps/google-calendar/triggers/new-calendar/index.ts b/packages/backend/src/apps/google-calendar/triggers/new-calendar/index.ts
new file mode 100644
index 00000000..564d9c10
--- /dev/null
+++ b/packages/backend/src/apps/google-calendar/triggers/new-calendar/index.ts
@@ -0,0 +1,33 @@
+import defineTrigger from '../../../../helpers/define-trigger';
+
+export default defineTrigger({
+ name: 'New calendar',
+ key: 'newCalendar',
+ pollInterval: 15,
+ description: 'Triggers when a new calendar is created.',
+ arguments: [],
+
+ async run($) {
+ const params: Record = {
+ pageToken: undefined as unknown as string,
+ };
+
+ do {
+ const { data } = await $.http.get('/v3/users/me/calendarList', {
+ params,
+ });
+ params.pageToken = data.nextPageToken;
+
+ if (data.items?.length) {
+ for (const calendar of data.items.reverse()) {
+ $.pushTriggerItem({
+ raw: calendar,
+ meta: {
+ internalId: calendar.etag,
+ },
+ });
+ }
+ }
+ } while (params.pageToken);
+ },
+});
diff --git a/packages/docs/pages/.vitepress/config.js b/packages/docs/pages/.vitepress/config.js
index c8844642..71676c16 100644
--- a/packages/docs/pages/.vitepress/config.js
+++ b/packages/docs/pages/.vitepress/config.js
@@ -114,6 +114,15 @@ export default defineConfig({
{ text: 'Connection', link: '/apps/gitlab/connection' },
],
},
+ {
+ text: 'Google Calendar',
+ collapsible: true,
+ collapsed: true,
+ items: [
+ { text: 'Triggers', link: '/apps/google-calendar/triggers' },
+ { text: 'Connection', link: '/apps/google-calendar/connection' },
+ ],
+ },
{
text: 'Google Drive',
collapsible: true,
diff --git a/packages/docs/pages/apps/google-calendar/connection.md b/packages/docs/pages/apps/google-calendar/connection.md
new file mode 100644
index 00000000..6024e6d8
--- /dev/null
+++ b/packages/docs/pages/apps/google-calendar/connection.md
@@ -0,0 +1,28 @@
+# Google Calendar
+
+:::info
+This page explains the steps you need to follow to set up the Google Calendar
+connection in Automatisch. If any of the steps are outdated, please let us know!
+:::
+
+1. Go to the [Google Cloud Console](https://console.cloud.google.com) to create a project.
+2. Click on the project drop-down menu at the top of the page, and click on the **New Project** button.
+3. Enter a name for your project and click on the **Create** button.
+4. Go to [API Library](https://console.cloud.google.com/apis/library) in Google Cloud console.
+5. Search for **Google Calendar API** in the search bar and click on it.
+6. Click on the **Enable** button to enable the API.
+7. Repeat steps 5 and 6 for the **People API**.
+8. Go to [OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent) in Google Cloud console.
+9. Select **External** here for starting your app in testing mode at first. Click on the **Create** button.
+10. Fill **App Name**, **User Support Email**, and **Developer Contact Information**. Click on the **Save and Continue** button.
+11. Skip adding or removing scopes and click on the **Save and Continue** button.
+12. Click on the **Add Users** button and add a test email because only test users can access the app while publishing status is set to "Testing".
+13. Click on the **Save and Continue** button and now you have configured the consent screen.
+14. Go to [Credentials](https://console.cloud.google.com/apis/credentials) in Google Cloud console.
+15. Click on the **Create Credentials** button and select the **OAuth client ID** option.
+16. Select the application type as **Web application** and fill the **Name** field.
+17. Copy **OAuth Redirect URL** from Automatisch to **Authorized redirect URIs** field, and click on the **Create** button.
+18. Copy the **Your Client ID** value from the following popup to the `Client ID` field on Automatisch.
+19. Copy the **Your Client Secret** value from the following popup to the `Client Secret` field on Automatisch.
+20. Click **Submit** button on Automatisch.
+21. Congrats! Start using your new Google Calendar connection within the flows.
diff --git a/packages/docs/pages/apps/google-calendar/triggers.md b/packages/docs/pages/apps/google-calendar/triggers.md
new file mode 100644
index 00000000..f05a8175
--- /dev/null
+++ b/packages/docs/pages/apps/google-calendar/triggers.md
@@ -0,0 +1,12 @@
+---
+favicon: /favicons/google-calendar.svg
+items:
+ - name: New calendar
+ desc: Triggers when a new calendar is created.
+---
+
+
+
+
diff --git a/packages/docs/pages/guide/available-apps.md b/packages/docs/pages/guide/available-apps.md
index 45a52157..2f5a189a 100644
--- a/packages/docs/pages/guide/available-apps.md
+++ b/packages/docs/pages/guide/available-apps.md
@@ -11,6 +11,7 @@ The following integrations are currently supported by Automatisch.
- [Formatter](/apps/formatter/actions)
- [GitHub](/apps/github/triggers)
- [GitLab](/apps/gitlab/triggers)
+- [Google Calendar](/apps/google-calendar/triggers)
- [Google Drive](/apps/google-drive/triggers)
- [Google Forms](/apps/google-forms/triggers)
- [Google Sheets](/apps/google-sheets/triggers)
diff --git a/packages/docs/pages/public/favicons/google-calendar.svg b/packages/docs/pages/public/favicons/google-calendar.svg
new file mode 100644
index 00000000..14b505ab
--- /dev/null
+++ b/packages/docs/pages/public/favicons/google-calendar.svg
@@ -0,0 +1,27 @@
+
+