Before you begin

The Google integration setup is 4 steps in Google Cloud Console, plus 2 steps in the Kura-chan dashboard — 6 total. About 15 minutes, and you don’t need to be a Google Cloud expert.

What you need

1. A Google account

   The one you want to connect. Personal accounts are easier. Workspace accounts owned by an employer or school may require admin approval.

2. Kura-chan running

   The picoclaw or launcher process must be up, and the dashboard reachable at http://localhost:8080.

3. A browser that allows cookies and pop-ups

   Google’s consent screen opens in a new tab. Incognito mode or aggressive privacy extensions can block parts of the flow — use a regular window.

4. 15 minutes of focused time

   You can stop anywhere, but the Client Secret in Step 4 is shown only once, so it’s safer to push through steps 4 and 5 back-to-back.

Why “bring your own OAuth client”?

Kura-chan doesn’t ship a shared OAuth app. Instead, you create your own OAuth client in your own Google Cloud project and Kura-chan uses those credentials — what the dashboard calls “BYO credentials”.

Three reasons this is worth 15 minutes:

1. No third party in the data path. The OAuth client is yours, so the tokens and API traffic flow between you and Google directly.
2. Transparent permissions. You can see exactly which scopes are active by opening your own Google Cloud Console.
3. Complete revocation. Delete the OAuth client and even we couldn’t restore access — because we never held it in the first place.

The trade-off is the 15 minutes of setup. Once done, it stays done.

Workspace account?

You can use a Workspace account, but if your admin has blocked external OAuth app creation, Step 1 will fail outright. In that case, create the OAuth client under a personal Google account and just connect the Workspace account in Step 6 — it works the same.

The shape of what’s ahead

Step	Where	What
1	Google Cloud Console	Create a GCP project
2	Google Cloud Console	Enable the Gmail / Calendar / Drive APIs
3	Google Cloud Console	Configure the OAuth consent screen
4	Google Cloud Console	Create an OAuth client ID (Desktop app), copy credentials
5	Kura-chan dashboard	Paste Client ID + Client Secret
6	Kura-chan dashboard + browser	Click Connect, complete OAuth in the browser tab

Then Verify the connection to make sure data actually flows.

Ready? Start at Step 1 · Create a GCP project.