Integrations
Lucille connects to outside services so she can see what's on your calendar, what your time tracker says, what's in your inbox, and so on. Each connection is called an integration.
You manage them in the web app at /integrations. Each integration has
its own page with a "Connect" button and per-integration settings.
What's available
| Integration | What Lucille can do | Where to connect |
|---|---|---|
| Telegram | One-on-one chat with the bot. The primary way you talk to Lucille. | /integrations/telegram |
| Google Calendar | Read events, find free time, surface "what's on today / this week." | /integrations/calendar.google |
| Google Mail | Read recent / unread mail, search by sender or subject, send drafts. | /integrations/mail.google |
| Google Keep | Read notes from your Keep account so Lucille can recall them. | /integrations/keep.google |
| Clockify (Time) | Pull time-tracking data; surface "where did my time go" thoughts. | /integrations/time |
| Check-ins | Schedule recurring prompts ("how are you doing?"). See Check-ins. | /integrations/checkin |
| Daily Brief | Automatic morning summary delivered to Telegram. See Day brief. | /integrations/daily_brief |
| Tasks / Open Loops | Capture and manage reminders and tasks. See Open loops. | Built-in; manage via chat or /open_loops. |
How a connection works
Most integrations use OAuth — you click "Connect," sign in to the service, and grant Lucille a scoped permission (e.g. read your calendar but not delete events). Tokens are stored encrypted; Lucille never sees your password.
For Clockify and a few other API-key services, you paste a key and Lucille stores it encrypted.
Statuses
On the /integrations page each connection shows a status:
- Connected — credentials valid, ready to use.
- Needs attention — token expired or revoked; reconnect to fix.
- Not connected — never set up.
- Error — something specific went wrong; the page explains.
What's not connected won't be used
If you ask Lucille "what's on my calendar" and you haven't connected Google Calendar, she'll say so — she won't make up events. Same for mail, time tracking, etc.
Disconnecting
Each integration page has a disconnect/revoke option. Disconnecting deletes Lucille's stored credentials and stops the integration from producing thoughts or briefs. Reconnect any time to bring it back.