What this is
Calendar Awareness is a supported skill that lets TutorClaw look at your upcoming events and help you think through your week. When enabled, you can ask questions about your schedule, and the assistant reads the calendar information.
Why it matters
This allows your assistant to help summarize your daily schedule and check for conflicts without sending any private details to the cloud.
Strictly Read-Only Access
TutorClaw can read calendar events only. It cannot create, edit, delete, move, invite, or cancel calendar events.
Think of it like giving a personal assistant access to a printed copy of your calendar — they can read it and tell you what is on it, but they cannot write anything new, erase anything, or make any changes on your behalf.
How to Set Up the Connection
1. Open the TutorClaw folder on your computer.
2. Run the calendar setup script (such as Start Calendar Connection.bat or equivalent setup command).
3. A browser window will open automatically, prompting you to log in to your Google Account and authorize permissions.
4. Google may show a "not verified" warning. This is normal for private local tools. Click Advanced, then click Go to TutorClaw (unsafe) to continue.
5. Click Allow to grant read-only access.
Local Authentication Tokens
TutorClaw will save two files locally on your computer:
credentials.json: Identifies your local app connection.token.json: A private access key to read your events.
Both files reside strictly on your own computer and should never be shared.
Use Chat as the Lab
Go back to the chat window (the lab) and try asking:
Show me my calendar safety limits.What appointments do I have this week?