Connect Google (Gmail + Calendar)

About 8 minutes. You'll create a Google Cloud OAuth app (one-time) and authorize Liege to access Gmail + Calendar APIs on your account. All tokens stay on your machine.

Step 1 — Create a Google Cloud project

1. Go to console.cloud.google.com/projectcreate
2. Project name: Liege Marketing (or whatever you want)
3. Click Create. Wait ~30 seconds.

Step 2 — Enable the APIs

While inside your new project, click each link in a new tab and hit Enable:

• Gmail API
• Calendar API

Step 3 — Configure the OAuth consent screen

1. Go to Google Auth Platform → OAuth overview → Get started
2. App name: Liege Marketing
3. User support email: your email
4. Audience: External
5. Contact: your email
6. Agree and Create

Step 4 — Create an OAuth client

1. Go to Clients → Create OAuth client
2. Application type: Desktop app
3. Name: Liege Desktop
4. Create
5. On the modal, click Download JSON OR copy the Client ID — we'll need both pieces shortly

Step 5 — Grab the client secret

1. Still on the client's detail page, scroll to Client secrets
2. Click Add secret → the new secret shows once (and only once)
3. Click the download icon next to the secret OR copy the value — e.g. GOCSPX-...

Step 6 — Wire it into Liege

In your terminal at the Liege folder:

setx GOOGLE_CLIENT_ID "<your-client-id>.apps.googleusercontent.com"
setx GOOGLE_CLIENT_SECRET "GOCSPX-<your-secret>"

# Mac:
export GOOGLE_CLIENT_ID="<your-client-id>.apps.googleusercontent.com"
export GOOGLE_CLIENT_SECRET="GOCSPX-<your-secret>"

Then run the OAuth flow:

cd skills/gmail-toolkit
node gmail.js auth

A browser tab opens. Sign in with the Gmail account you added as test user. Approve the scopes. You'll see:

✅ authorized yorname@gmail.com
   refresh_token saved (never expires until revoked)
   access_token saved (1 hour)

Step 7 — Verify

node gmail.js status
node gmail.js profile
node gmail.js cal-list

You should see your mailbox stats and upcoming calendar events.

Troubleshooting

• "app not verified" / "access blocked" — you skipped Step 3's test-user step. Add yourself.
• "redirect_uri_mismatch" — you picked the wrong app type. Must be Desktop app, not Web.
• "invalid_grant" — the refresh token was revoked or expired. Re-run gmail.js auth.

Next

Connect Meta (Facebook + Instagram) →