Skip to main content
The Gmail connector projects inbox and sent mail as read-only Markdown and uses reviewed files under draft/ to create Gmail drafts.

Connect

Locality requests scoped Gmail read-only and compose access. It does not request the full-mailbox https://mail.google.com/ scope.

Mount

Optional mount settings include --view messages|threads and a bounded date window with both --after YYYY-MM-DD and --before YYYY-MM-DD.

Projection

  • inbox/ and sent/ are read-only;
  • attachments are projected under stable local attachment paths;
  • draft/ accepts new Markdown files directly inside the directory.

Creating a draft

Review and push the file with loc diff and loc push -y. Locality creates a Gmail UI draft; it does not send mail.

Current limits

  • Existing inbox and sent messages cannot be edited.
  • Draft files must be direct children of draft/.
  • V1 creates drafts but does not send, reply, forward, label, archive, or delete messages.