MailMerge-JS is a next-generation Gmail automation tool supercharged by AI. Effortlessly draft and send highly personalized templated emails without worrying about email templating and data massaging, all from your Gmail inbox.
MailMerge-JS leverages the power of GenAI and the Gmail API to streamline the email drafting process. Write your templates in any format you prefer (HTML/Markdown/Text/Jinja) and loosely express variables and directives in pseudocode using double curly braces {{ }}. The AI will then generate the actual email content for you, synthesized against any data file format you provide.
- Bring Your Own Keys and Credentials: Maintain control over your API keys and credentials.
- Scale: Draft and send emails at scale, perfect for large outreach campaigns.
- Flexibility: Understands loose or missing data requirements, making it adaptable to various data sources.
- Free and Open-Source: Completely free to use and modify.
- OpenAI Integration: Enhances the email drafting process with AI-powered content generation.
To install MailMerge-JS, use the following commands:
npm install -g mailmerge-js
mailmerge setupSetup will guide you through the process of setting up your MailMerge-JS environment. To get the most out of this tool, you will need an OpenAI API key and Google App credentials.
This tool requires Google App credentials to draft and send emails. Here is how you can obtain those credentials:
- Go to the Google Developer Console.
- Create a new project.
- Enable the Gmail API for that project.
- Add the following scopes to the project:
https://www.googleapis.com/auth/gmail.sendhttps://www.googleapis.com/auth/gmail.compose
- Create credentials for a desktop application.
- Download the JSON file
NOTICE (5/22/2024) - We used to provide a simple way to authorize via a hosted web server. This is no longer supported due to difficulties with getting Google App Approval. You will need to provide your own application credentials
To use OpenAI features you will need an OpenAI developer API key (read more to see how you can use our tool with local LLMs)
You can sign up on OpenAI's website. Get your API key from the OpenAI API Keys page.
We also support using this tool with local language models thru Ollama. For example, to compose emails using llama3, you will feed the following
flag to the compose command: --renderer llama3
Install Ollama by following the instructions here.
We also support a non-AI version of this tool via Nunjucks. You need to modify your contact and template files according to the Nunjucks example provided in the examples folder. To compose emails using Nunjucks, use the following flag with the compose command: --renderer nunjucks.
mailmerge compose --contacts ./examples/sample-contacts.csv ./examples/outreach-template.md
# Subject
{{ "Insert some subject related to connecting via their company or title, whichever more appropriate" }}
# Body
Hi {{first name}},
I hope this message finds you well. I'm Bob from MailMerge-JS, a startup that's building a tool to automate email outreach.
I came across your profile and was impressed by your track record in {{ industry in company }} and wanted to show
you how our tool can help you automate {{ insert reason to use the outreach tool based on their title }}
Would you be open to a quick chat next week?
Best,
Bob @ MailMerge-JS
[https://mailmerge-js.dev](https://mailmerge-js.dev)name,email,company,position
John Doe,john.doe@example.com,Crunch Fitness,Fitness Instructor
Jane Smith,jane.smith@example.com,Coca-Cola,CTO
Alice Johnson,alice.johnson@example.com,Microsoft,Product Manager
Bob Brown,bob.brown@example.com,Bank of America,Marketing Director
We welcome contributions! See CONTRIBUTING.md for details.
Licensed under the MIT License. See LICENSE for details.
Our hosted server endpoint on the mailmerge-js.dev domain is used solely for authorizing our app against Google APIs. We do not store any data; all tokens are stored on the user side. We do not collect or store any data. The server code can be inspected in this repository.
Note: This privacy policy only applies if you are using the hosted server.
The server exists to make the app more accessible for users setting up the CLI. Its purpose is to obfuscate our own credentials from abuse. We do not collect or store any data.
Note: These terms of service only apply if you are using the hosted server.
Made with ❤️ by charlesyu108 & ryanhuang519