Minimal personal assistant. Telegram-based interface.
Handles email, tasks, events — fast and fluid.
Ask. It acts.
Via Telegram, you can:
- Summarize recent emails
- Add or check tasks (Google Tasks)
- Schedule or view calendar events (Google Calendar)
- Talk in plain language — Gemini interprets
- Telegram Bot API – Messaging layer
- Gemini Pro (Google LLM) – Context, understanding
- Gmail API – Email fetch & parse
- Google Tasks API – Personal to-dos
- Google Calendar API – Scheduling
- n8n – Orchestration and automation
- Clone this repo.
- Create
.envwith:TELEGRAM_TOKEN= GEMINI_API_KEY= GMAIL_CREDENTIALS_JSON= GOOGLE_TASKS_CREDENTIALS_JSON= GOOGLE_CALENDAR_CREDENTIALS_JSON= - Set up Google Cloud project (OAuth2 access).
- Deploy with n8n self-hosted or cloud.
- Gemini parses request: "What are my tasks today?"
- n8n routes to appropriate service
- Response sent back via Telegram
All Google services use OAuth2. Tokens are refreshed automatically.
Keep .env and tokens/ outside of version control.
/Personal Assistant.json– Import into n8n/src/– Service modules (Gmail, Calendar, etc.)/docs/– API scopes, OAuth setup
- Rate limits apply (especially Gmail).
- Gemini might infer wrong intent — prompt carefully.
- Telegram replies are plain text (no rich UI yet).
- Integrate Google Drive support
- Enable recurring reminders
- Add voice commands (via Whisper + Telegram voice)
- UI layer (React or Tauri, maybe)
MIT.