Run your Google Tasks list from Telegram

Whenever a message arrives in your Telegram chat, the bot checks whether it is one of three commands and acts on one Google Tasks list for you. Send /add and a title to file a task with exactly that title, /list to see everything still open with its ID, and /done with a title or ID to tick one off. Messages that are not commands are ignored.

Ticking a task off cannot be undone from the chat, so the match is strict: the words after /done must be a task's whole title or its ID, and only open tasks count. If two open tasks share a name, nothing is ticked off and the bot replies with both IDs so you can choose. No AI reads or rewrites your message, so what you type is exactly what is stored, and a long list is cut short with a note of how many tasks were left out.

You need a Telegram bot in a private chat, since anyone who can message it can change the list, and the name of a Google Tasks list on your account. If no list matches, the run stops and lists the names it found.

TelegramWhen a new message is received. Save it as incomingMessage.When a new message is received. Save it as incomingMessage.

Set taskListName to blank.Set taskListName to blank.

Set maxTasksListed to 20.Set maxTasksListed to 20.

Set messageText to blank.Set messageText to blank.

If a step below fails, save the error as noTextErrorIf a step below fails, save the error as noTextError

Try

Trim incomingMessage.text and save it as messageText.Trim incomingMessage.text and save it as messageText.

On error

No steps

If messageText is emptyIf messageText is empty

Yes

Finish the run: That message carried no text, so there was no command in it.Finish the run: That message carried no text, so there was no command in it.

No

No steps

If messageText doesn't start with /If messageText doesn't start with /

Yes

Finish the run: That message was not a command, so it was left alone. Commands start with a slash: /add, /list or /done.Finish the run: That message was not a command, so it was left alone. Commands start with a slash: /add, /list or /done.

No

No steps

Set chatId to incomingMessage.chat_id.Set chatId to incomingMessage.chat_id.

Split messageText by a space and save it as words.Split messageText by a space and save it as words.

Get the first item of words and save it as firstWord.Get the first item of words and save it as firstWord.

Make the first item of firstWord split by @ lowercase and save it as command.Make the first item of firstWord split by @ lowercase and save it as command.

Replace / with in command and save it as verb.Replace / with in command and save it as verb.

Trim the items from index 1 onward of words joined by a space and save it as commandArgument.Trim the items from index 1 onward of words joined by a space and save it as commandArgument.

Set isKnownCommand to verb is add or verb is list or verb is done.Set isKnownCommand to verb is add or verb is list or verb is done.

If isKnownCommand is noIf isKnownCommand is no

Yes

Set helpIntro to:Set helpIntro to:I look after your Google Tasks list. Send me one of these:

Set helpAdd to:Set helpAdd to:/add Call the dentist adds a task

Set helpList to:Set helpList to:/list shows what is still open, with each task's ID

Set helpDone to:Set helpDone to:/done Call the dentist ticks off the open task with exactly that name

Set helpNote to If two open tasks share a name I will not guess between them - send /done with the ID from /list instead..Set helpNote to If two open tasks share a name I will not guess between them - send /done with the ID from /list instead..

Set helpText to helpIntro plus helpAdd plus helpList plus helpDone plus helpNote.Set helpText to helpIntro plus helpAdd plus helpList plus helpDone plus helpNote.

TelegramSend a message to chat chatId.Send a message to chat chatId.helpText

Finish the run: The message was not one of /add, /list or /done, so the chat was sent the list of commands.Finish the run: The message was not one of /add, /list or /done, so the chat was sent the list of commands.

No

No steps

Google TasksList lists. Save it as taskListsResult.List lists. Save it as taskListsResult.

Set taskLists to taskListsResult.task_lists.Set taskLists to taskListsResult.task_lists.

Make taskListName lowercase and save it as wantedList.Make taskListName lowercase and save it as wantedList.

Set taskListId to blank.Set taskListId to blank.

Set knownListNames to an empty list.Set knownListNames to an empty list.

For each taskList in taskLists:For each taskList in taskLists:

Set candidateListName to blank.Set candidateListName to blank.

If a step below fails, save the error as listNameErrorIf a step below fails, save the error as listNameError

Try

Trim taskList.title and save it as candidateListName.Trim taskList.title and save it as candidateListName.

On error

No steps

If candidateListName isn't emptyIf candidateListName isn't empty

Yes

Add candidateListName to the end of knownListNames and save it as knownListNames.Add candidateListName to the end of knownListNames and save it as knownListNames.

If candidateListName in lowercase is wantedList and taskListId is emptyIf candidateListName in lowercase is wantedList and taskListId is empty

Yes

If a step below fails, save the error as listIdErrorIf a step below fails, save the error as listIdError

Try

Trim taskList.id and save it as taskListId.Trim taskList.id and save it as taskListId.

On error

No steps

No

No steps

No

No steps

If taskListId is emptyIf taskListId is empty

Yes

Join knownListNames with , and save it as knownLists.Join knownListNames with , and save it as knownLists.

Set noListText to I could not find a Google Tasks list called '@taskListName'. The lists on this account are: knownLists.Set noListText to I could not find a Google Tasks list called '@taskListName'. The lists on this account are: knownLists.

TelegramSend a message to chat chatId.Send a message to chat chatId.noListText

Stop and report a problem: No Google Tasks list is named '@taskListName'. Correct the 'taskListName' step to match one of the lists on the account.Stop and report a problem: No Google Tasks list is named '@taskListName'. Correct the 'taskListName' step to match one of the lists on the account.

No

No steps

If verb is addIf verb is add

Yes

If commandArgument is emptyIf commandArgument is empty

Yes

TelegramSend a message to chat chatId.Send a message to chat chatId.Send the task after the command, like this: /add Call the dentist

No

Google TasksCreate task commandArgument in Google Tasks list taskListId.Create task commandArgument in Google Tasks list taskListId.

Set addedText to Added to taskListName: commandArgument.Set addedText to Added to taskListName: commandArgument.

TelegramSend a message to chat chatId.Send a message to chat chatId.addedText

No

No steps

If verb is listIf verb is list

Yes

Google TasksList tasks in Google Tasks list taskListId. Save it as openTasksResult.List tasks in Google Tasks list taskListId. Save it as openTasksResult.

Set openTasks to openTasksResult.tasks.Set openTasks to openTasksResult.tasks.

Set openTaskCount to 0.Set openTaskCount to 0.

If a step below fails, save the error as openCountErrorIf a step below fails, save the error as openCountError

Try

Count the items in openTasks and save it as openTaskCount.Count the items in openTasks and save it as openTaskCount.

On error

No steps

Set taskLines to an empty list.Set taskLines to an empty list.

Set listedCount to 0.Set listedCount to 0.

For each task in openTasks:For each task in openTasks:

If listedCount multiplied by 1 is greater than or equal to maxTasksListed… If listedCount multiplied by 1 is greater than or equal to maxTasksListed…

Yes

Stop repeating.Stop repeating.

No

No steps

Set lineId to blank. Set lineId to blank.

If a step below fails, save the error as lineIdError If a step below fails, save the error as lineIdError

Try

Trim task.id and save it as lineId.Trim task.id and save it as lineId.

On error

No steps

Set lineTitle to blank. Set lineTitle to blank.

If a step below fails, save the error as lineTitleError If a step below fails, save the error as lineTitleError

Try

Trim task.title and save it as lineTitle.Trim task.title and save it as lineTitle.

On error

No steps

If lineId isn't empty If lineId isn't empty

Yes

If lineTitle is emptyIf lineTitle is empty

Yes

Change lineTitle to (this task has no title).Change lineTitle to (this task has no title).

No

No steps

Add lineTitleAdd lineTitle ID: lineId to the end of taskLines and save it as taskLines.

Add 1 to listedCount.Add 1 to listedCount.

No

No steps

If taskLines is emptyIf taskLines is empty

Yes

Set nothingOpenText to Nothing is open in taskListName right now.Set nothingOpenText to Nothing is open in taskListName right now.

TelegramSend a message to chat chatId.Send a message to chat chatId.nothingOpenText

No

Set listHeading to Open in taskListName:Set listHeading to Open in taskListName: .

Join taskLines with a blank line and save it as listBody.Join taskLines with a blank line and save it as listBody.

Set listFooter to blank.Set listFooter to blank.

If openTaskCount multiplied by 1 is greater than listedCount multiplied by 1If openTaskCount multiplied by 1 is greater than listedCount multiplied by 1

Yes

Change listFooter to Change listFooter to Showing the first listedCount of openTaskCount open tasks.

No

No steps

Set listText to listHeading plus listBody plus listFooter.Set listText to listHeading plus listBody plus listFooter.

TelegramSend a message to chat chatId.Send a message to chat chatId.listText

No

No steps

If verb is doneIf verb is done

Yes

If commandArgument is emptyIf commandArgument is empty

Yes

TelegramSend a message to chat chatId.Send a message to chat chatId.Say which task to tick off, like this: /done Call the dentist Or send /done with the task's ID from /list.

No

Google TasksList tasks in Google Tasks list taskListId. Save it as candidateResult.List tasks in Google Tasks list taskListId. Save it as candidateResult.

Set candidateTasks to candidateResult.tasks.Set candidateTasks to candidateResult.tasks.

Make commandArgument lowercase and save it as wantedTask.Make commandArgument lowercase and save it as wantedTask.

Set matchedIds to an empty list.Set matchedIds to an empty list.

Set matchedTitles to an empty list.Set matchedTitles to an empty list.

For each candidate in candidateTasks:For each candidate in candidateTasks:

Set candidateId to blank. Set candidateId to blank.

If a step below fails, save the error as candidateIdError If a step below fails, save the error as candidateIdError

Try

Trim candidate.id and save it as candidateId.Trim candidate.id and save it as candidateId.

On error

No steps

Set candidateTitle to blank. Set candidateTitle to blank.

If a step below fails, save the error as candidateTitleError If a step below fails, save the error as candidateTitleError

Try

Trim candidate.title and save it as candidateTitle.Trim candidate.title and save it as candidateTitle.

On error

No steps

If candidateId isn't empty If candidateId isn't empty

Yes

Set idMatches to candidateId is commandArgument.Set idMatches to candidateId is commandArgument.

Set titleMatches to the length of candidateTitle is greater than 0 and candidateTitle in lowercase is wantedTask.Set titleMatches to the length of candidateTitle is greater than 0 and candidateTitle in lowercase is wantedTask.

If idMatches is yes or titleMatches is yesIf idMatches is yes or titleMatches is yes

Yes

Add candidateId to the end of matchedIds and save it as matchedIds.Add candidateId to the end of matchedIds and save it as matchedIds.

Add candidateTitle to the end of matchedTitles and save it as matchedTitles.Add candidateTitle to the end of matchedTitles and save it as matchedTitles.

No

No steps

No

No steps

If matchedIds is emptyIf matchedIds is empty

Yes

Set noMatchText to Nothing open in taskListName is called '@commandArgument', so nothing was ticked off. Send /list to see what is open.Set noMatchText to Nothing open in taskListName is called '@commandArgument', so nothing was ticked off. Send /list to see what is open.

TelegramSend a message to chat chatId.Send a message to chat chatId.noMatchText

No

No steps

If the length of matchedIds is greater than 1If the length of matchedIds is greater than 1

Yes

Join matchedIds with "Join matchedIds with ID: and save it as ambiguousIds.

Set ambiguousIntro to More than one open task is called '@commandArgument', so nothing was ticked off.Set ambiguousIntro to More than one open task is called '@commandArgument', so nothing was ticked off.

Set ambiguousText to ambiguousIntro Send /done with one of these IDs instead:Set ambiguousText to ambiguousIntro Send /done with one of these IDs instead: ID: ambiguousIds.

TelegramSend a message to chat chatId.Send a message to chat chatId.ambiguousText

No

No steps

If the length of matchedIds is 1If the length of matchedIds is 1

Yes

Get the first item of matchedIds and save it as targetId.Get the first item of matchedIds and save it as targetId.

Get the first item of matchedTitles and save it as targetTitle.Get the first item of matchedTitles and save it as targetTitle.

If targetTitle is emptyIf targetTitle is empty

Yes

Change targetTitle to targetId.Change targetTitle to targetId.

No

No steps

Google TasksComplete task targetId in Google Tasks list taskListId.Complete task targetId in Google Tasks list taskListId.

Set doneText to Ticked off: targetTitle.Set doneText to Ticked off: targetTitle.

TelegramSend a message to chat chatId.Send a message to chat chatId.doneText

No

No steps

No

No steps