Telegram AI assistant for your mail, calendar and tasks

Telegram AI assistant for your mail, calendar and tasks

An n8n workflow that turns a Telegram bot into a personal assistant. You send a text or a voice message, an OpenAI agent
answers, and it can read your unread Gmail, your Google Calendar and your Baserow tasks and contacts.

What is inside

• workflow.json: the workflow as n8n exports it, 15 nodes, two of them sticky notes. It holds no credential. One note labels
  the part that handles the Telegram request, and the other holds Mindket's setup notes.
• README.md: these notes.

What we changed from the original copy

• Every node that needs a sign-in was linked to a credential in its author's n8n. The links are gone, so select your own.
• The Telegram Trigger was version 1 and answered any Telegram user who found the bot, so anyone could ask for your mail, calendar
  and tasks. It is now version 1.2 with Restrict to User IDs set to <YOUR_TELEGRAM_USER_ID>.
• Google Calendar named its author's calendar by Google address. It is now set by id to <YOUR_GOOGLE_CALENDAR_ID>.
• Tasks and Contacts held their author's Baserow database and table ids. They now hold <YOUR_BASEROW_DATABASE_ID>,
  <YOUR_BASEROW_TASKS_TABLE_ID> and <YOUR_BASEROW_CONTACTS_TABLE_ID>. Both also use a Baserow database token in place of the
  deprecated username and password sign-in.
• OpenAI Chat Model used gpt-4o-mini, which OpenAI lists for shutdown on 14 January 2027. It now uses gpt-5.6-terra.
• The agent node's name had an emoji in it. It is now Angie, AI Assistant, and the lines that point at it follow the new name.
• The sticky note that linked the author's video tutorial was replaced by short setup notes.
• The Telegram Trigger's webhook id is gone, and n8n makes a new one when you import the file.
• The export's instance id is gone.
• Nothing else. The system message, the tools and the memory are as they were.

Before you start

• An n8n instance that Telegram can reach over HTTPS, on n8n Cloud or on your own server.
• A Telegram bot and its token, made by messaging BotFather in Telegram, and your own Telegram user id.
• An OpenAI API key.
• A Gmail account and a Google Calendar, each linked through n8n's Google sign-in.
• A Baserow database with a tasks table and a contacts table, and a Baserow database token.

Set it up

1. In n8n, create a workflow, open its menu and choose Import from File. Pick workflow.json.
2. Add a Telegram credential with your bot's token. Select it in Listen for incoming events, Get Voice File and Telegram.
3. Add an OpenAI credential and select it in OpenAI Chat Model and Speech to Text.
4. Add a Gmail OAuth2 credential and select it in Get Email. Add a Google Calendar OAuth2 credential and select it in
   Google Calendar.
5. In Baserow, create a database token under My settings, Database tokens. In n8n, add a Baserow Token API credential and select
   it in Tasks and Contacts.
6. In both Baserow nodes, replace <YOUR_BASEROW_DATABASE_ID>. Replace <YOUR_BASEROW_TASKS_TABLE_ID> in Tasks and
   <YOUR_BASEROW_CONTACTS_TABLE_ID> in Contacts. They are the numbers in a table's address in Baserow.
7. In Google Calendar, replace <YOUR_GOOGLE_CALENDAR_ID> with your calendar's id. For your main calendar that is your Google
   address.
8. In Listen for incoming events, replace <YOUR_TELEGRAM_USER_ID> with your own Telegram user id. To find it, clear the field,
   press Listen for test event, message your bot and read message.from.id in the output.
9. Publish the workflow, then message your bot with a text or a voice note.

How a run goes

1. Listen for incoming events takes a new message from the user you allowed.
2. Voice or Text copies the message text into a text field.
3. If checks that field. An empty text means a voice message, and it goes to Get Voice File, which downloads the recording.
   Speech to Text turns it into text. A message with text skips both nodes.
4. Angie, AI Assistant reads the text. Its system message sets the rules. Skip promotional mail. For mail, give the sender,
   date, subject and a short summary. Use the Baserow tool for tasks. Assume today when no date is given. Leave out calendar
   events that do not fit the question. The agent can call Get Email, Google Calendar, Tasks and Contacts, and
   Window Buffer Memory gives it the last five exchanges with that sender.
5. Telegram sends the answer back to the sender in Markdown mode, with n8n's attribution line turned off.

Change the look

• Who the assistant is and how it answers: the system message in Angie, AI Assistant.
• Which unread mail it can see: the filters in Get Email. It asks for unread inbox mail after a date that the model sets.
• Which calendar and which fields: Google Calendar.
• Which tables it reads: Tasks and Contacts. Their operation is the node's default, Get Many, so they only read.
• How much it remembers: the Context Window Length in Window Buffer Memory.
• The model: OpenAI Chat Model.

Good to know

• The bot can read your mail, calendar and tasks, so the sender check matters. Until you fill in <YOUR_TELEGRAM_USER_ID> the bot
  ignores everyone. n8n applies Restrict to User IDs from Telegram Trigger version 1.2 on, which is why the copy uses that version.
• Models: OpenAI's deprecations page, read on 12 November 2026, lists gpt-4o-mini for shutdown on 14 January 2027 with
  gpt-6-luna as the replacement. Mindket's copy uses gpt-5.6-terra instead. The model page for gpt-6-luna says Chat
  Completions supports function calling only with reasoning effort set to none, and this agent calls tools through a node that
  never sends that setting. The swap was not run from here. The same deprecations page lists whisper-1 for removal on 26
  February 2027 with gpt-live-transcribe or gpt-transcribe as the replacement. Speech to Text fixes the model and offers no
  choice.
• Google Calendar asks for only the title and start time of each event. An all-day event has a date and no time, so it comes
  back without a start.
• A photo or a sticker has no text, so it takes the voice path, and the run stops with an error there.
• Telegram sends in Telegram's Markdown mode. Telegram's Bot API page says _, *, a backtick and [ outside an entity need a
  backslash in that mode, and an unmatched one makes Telegram refuse the message. The node's error output is connected to nothing,
  so a refused reply is dropped without a sign. Telegram also refuses text over 4,096 characters.
• Window Buffer Memory keeps the last five exchanges for each sender in n8n's memory and loses them when n8n restarts.
• n8n marks the Baserow username and password type as deprecated, so Mindket's copy sets both Baserow tools to a database token.
• Each message costs at least one OpenAI call, and a voice note adds a transcription. Mail, events and task rows go to OpenAI
  when the agent reads them.
• Not run: nothing here was run against Telegram, OpenAI, Google or Baserow. These notes come from n8n's source and the vendors'
  pages, read on 12 November 2026.