CloudMeet
A simple, self-hosted meeting scheduler built on Cloudflare. Open-source Calendly alternative with Google Calendar and Outlook Calendar integration.
Features
- Google Calendar and Outlook Calendar integration
- Use Google alone, Outlook alone, or both calendars together
- Automatic event creation with Google Meet or Microsoft Teams links
- Customizable availability and working hours
- Multiple event types (30 min, 1 hour, etc.)
- Configurable email notifications (confirmation, cancellation, reminders)
- Email settings dashboard to enable/disable and customize emails
- One-click deploy and update via GitHub Actions
- Runs entirely on Cloudflare’s free tier
Quick Start
1. Create Cloudflare API Token
- Go to Cloudflare API Tokens
- Click Create Token
- Select Edit Cloudflare Workers template
- Under Account Resources, select your account
- Click + Add more and add: Account → D1 → Edit
- Click Continue to summary → Create Token
- Copy the token for step 4
2. Setup Google OAuth
-
Go to Google Cloud Console
-
Create a new project
-
Go to APIs & Services > Library > Enable Google Calendar API
-
Go to APIs & Services > Credentials
-
Click Create Credentials > OAuth 2.0 Client ID
-
Application type: Web application
-
Add authorized redirect URI:
https://YOUR-PROJECT.pages.dev/auth/callback- Replace
YOUR-PROJECTwith your Cloudflare Pages project name (you’ll get this URL after first deploy, or use your custom domain if you already have one) - You can add multiple redirect URIs, so add both the default and custom domain if needed
- Replace
-
Save your Client ID and Client Secret for step 4
3. Create your repository
Click Use this template > Create a new repository.
4. Add Repository Secrets
Go to your new repo’s Settings > Secrets and variables > Actions > New repository secret.
Add these secrets (click “New repository secret” for each one):
| Secret | Required | Description |
|---|---|---|
CLOUDFLARE_API_TOKEN | Yes | Your Cloudflare API token from step 1 |
CLOUDFLARE_ACCOUNT_ID | Yes | Your Cloudflare Account ID (right sidebar) |
ADMIN_EMAIL | Yes | Your Google email (only this account can login) |
JWT_SECRET | Yes | Random string for session tokens (generate one) |
APP_URL | Yes | Your app URL (e.g., https://YOUR-PROJECT.pages.dev or your custom domain) |
GOOGLE_CLIENT_ID | Yes | From step 2 (ends with .apps.googleusercontent.com) |
GOOGLE_CLIENT_SECRET | Yes | From step 2 |
EMAILIT_API_KEY | No | Emailit API key for booking emails |
EMAIL_FROM | No | From address (e.g., [email protected]) |
CRON_SECRET | No | Secures reminder endpoint (generate one) |
MICROSOFT_CLIENT_ID | No | For Outlook Calendar integration (see below) |
MICROSOFT_CLIENT_SECRET | No | For Outlook Calendar integration (see below) |
5. Deploy
Go to Actions > Deploy to Cloudflare Pages > Run workflow > Run workflow.
Your app will be live at https://YOUR-PROJECT.pages.dev.
Custom Domain (Optional)
- Go to Cloudflare Dashboard > Pages > cloudmeet > Custom domains
- Add your domain
- Update
APP_URLsecret to your new domain - Update redirect URI in Google Cloud Console to
https://yourdomain.com/auth/callback - Re-run the deploy workflow
Updating
To get the latest updates from the template and deploy:
- Go to Actions > Sync and Deploy > Run workflow > Run workflow
This will sync with the upstream CloudMeet template and automatically deploy to Cloudflare.
Alternatively, you can run Upstream Sync and Deploy to Cloudflare Pages separately.
If sync fails with a permissions error, create a personal access token with Contents and Workflows permissions, and paste it in the token field when running the workflow.
Email Reminders
Email reminders are automatically enabled when you deploy. A Cloudflare Worker runs every 5 minutes to check for and send scheduled reminders (24h, 1h before meetings).
Note: The CRON_SECRET is optional but recommended. Without it, the reminder endpoint is publicly accessible (anyone could trigger reminder sends). With it, only the cron worker can trigger reminders.
To add the secret:
- Add a
CRON_SECRETto your GitHub secrets (any random string) - Re-deploy via Actions > Deploy to Cloudflare Pages
The cron worker is deployed automatically alongside the main app.
Outlook Calendar Integration (Optional)
CloudMeet supports Microsoft Outlook Calendar in addition to Google Calendar. You can use Google alone, Outlook alone, or both together. When both are connected, availability is checked across both calendars.
Setup Microsoft OAuth
-
Go to Azure Portal > App registrations > New registration
-
Name:
CloudMeet(or your preferred name) -
Supported account types: Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)
-
Redirect URI: Web >
https://YOUR-DOMAIN/auth/outlook/callback -
Click Register
-
Copy the Application (client) ID - this is your
MICROSOFT_CLIENT_ID -
Go to Certificates & secrets > New client secret
-
Copy the secret value - this is your
MICROSOFT_CLIENT_SECRET -
Go to API permissions > Add a permission > Microsoft Graph > Delegated permissions
-
Add these permissions:
Calendars.ReadWriteUser.ReadOnlineMeetings.ReadWrite(for Teams meeting links)
-
Click Grant admin consent (if you have admin access, otherwise users consent on first login)
Add Secrets
Add MICROSOFT_CLIENT_ID and MICROSOFT_CLIENT_SECRET to your GitHub secrets and re-deploy.
Usage
Once configured, users can connect their Outlook calendar from the dashboard:
- Go to Dashboard > Calendar Integrations
- Click Connect next to Outlook Calendar
- Choose which calendars to use for availability checking
- Select preferred meeting provider (Google Meet, Teams, or none)
Local Development
cp .env.example .dev.vars # Add your credentials
npm install
npm run db:init
npm run dev
License
MIT
