Skip to content

Latest commit

 

History

History
59 lines (36 loc) · 5 KB

README.md

File metadata and controls

59 lines (36 loc) · 5 KB
Raw

GmailSendLater is a Google Apps Script that lets you send a Gmail draft at a specified time in the future. If you're writing work emails at 2am but want to preserve the illusion of work-life balance, you can use this script to sleep in and have the emails automatically sent at 9am as if they were sent by a normal human.

Installing

You can install GmailSendLater directly by visiting the installation page and granting the application the permissions it needs (see Required Permissions, below).

If you want to customize the code for your installation, you can perform a Manual Installation.

Uninstalling

Visit GmailSendLater's installation page and click the uninstall button.

Usage

  1. Create a draft email that you would like sent.
  2. To have that draft sent at 9am tomorrow, add a new label to the thread containing the draft named "send at 9am tomorrow".
  3. The draft will automatically be sent at 9am tomorrow by Google's servers. You don't have to be logged into Gmail or even have your computer on.

More detailed usage instructions are on the GmailSendLater wiki.

You can use natural language to express the time at which the email should be sent. Try out different expressions at the SugarJS Dates site. If GmailSendLater doesn't understand the time you typed, it will add the GmailSendLater/error label to the thread and the draft will not be sent.

GmailSendLater will automatically delete these labels after the drafts have been sent, to avoid cluttering your Gmail account.

Features & Limitations

Features:

  • The time at which a draft should be sent is specified via a label, so the formatting of the draft is not affected by GmailSendLater.
  • You can easily send a bunch of drafts at a specific time, by labeling them all at once.
  • Threading with drafts is preserved, just as if you hit the "send" button yourself.
  • GmailSendLater tries to be smart about the times you specify. If it's 8pm on Thursday and you specify that a draft should be sent at "9am", it will assume you mean 9am Friday morning.
  • You can use GmailSendLater anywhere you can add a label to an email: any browser and even mobile apps. Note that while you cannot create new labels in the Gmail Android app or on the mobile Gmail website, you can apply existing labels.
  • GmailSendLater renames each label to a more verbose time format before sending. This lets you verify that GmailSendLater understands when you want a draft to be sent. Removing this label will prevent the draft from being sent.
  • GmailSendLater is free and open source, and always will be.

Known limitations:

  • If there are multiple drafts per thread, they will all be sent at the same time via GmailSendLater (since labels are per-thread, not per-message).
  • If a draft is sent manually and then sending is undone, GmailSendLater will not be able to send this draft subsequently. I believe this is because, on undo, a draft is re-created with a new draft ID but the list of drafts accessible via the Gmail API is not updated with the new ID. Thus, the re-created draft is not reachable via the API so GmailSendLater cannot send it.

Required Permissions

GmailSendLater requires several permissions to run. These should not be granted lightly - this is your email account after all! Here's an explanation of why each permission is needed.

  • View and manage your mail: used to find the drafts to send and to manipulate their labels

  • View and manage data associated with the application: used to log the script's execution for debugging purposes

  • Allow this application to run when you are not present: allows emails to be sent at any time, whether you are logged in or not

  • Connect to an external service: needed to actually send the emails, which occurs via the Gmail API. Google Apps Script does not currently offer 1) a clean way to send a draft (instead, the draft must be copied and the copy sent) which results in issues with message threading, or 2) any way to discard drafts (which results in drafts remaining in the message thread after sending). Thus, making calls to the Gmail API (which counts as an external web service) is required.

Shout-outs

I was inspired to write this by the Gmail Delay Send script which offers similar functionality with a different UI. Check it out: maybe you'll like it better!

GmailSendLater uses the excellent SugarJS library from Andrew Plummer, which makes the code a lot cleaner.

GmailSendLater uses the Google Apps Script version of QUnit for testing.