explaingit

ninad-hazarika/outreach-automation-v1

Analysis updated 2026-05-18

0JavaScriptAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

TLDR

A Google Sheets and Apps Script tool that tracks and sends personal cold outreach emails, with manual approval required before anything is sent.

Mindmap

mindmap
  root((outreach-automation-v1))
    What it does
      Tracks outreach in a spreadsheet
      Creates Gmail drafts from sheet data
      Sends only after manual approval
    Tech stack
      JavaScript
      Google Apps Script
      Gmail
      Telegram
    Use cases
      Track internship or job outreach emails
      Send approved follow-up emails automatically
      Get Telegram alerts on outreach activity
    Audience
      Students job hunting
      Individuals doing small scale outreach
    Safety
      Test mode
      Daily send limit
      Per-row approval checkboxes

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Track and send personalized outreach emails to a shortlist of companies or professors during a job search.

USE CASE 2

Automatically create and send an approved follow-up email after no reply within a set time.

USE CASE 3

Get an hourly Telegram summary of outreach activity without checking the spreadsheet yourself.

What is it built with?

JavaScriptGoogle Apps ScriptGmailTelegram

How does it compare?

ninad-hazarika/outreach-automation-v100kaku/gallery-slider-block0xkinno/vellum
Stars00
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-19
MaintenanceDormant
Setup difficultymoderateeasyhard
Complexity2/52/54/5
Audiencevibe codergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires a Google account, manual spreadsheet setup with specific tabs, and a Telegram bot for alerts.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

outreach-automation-v1 turns a Google Sheet into a simple personal system for tracking cold outreach emails, built for a student handling an internship or job search rather than a business running a marketing campaign. It uses only tools people already have free access to as a student: Google Sheets, Google Apps Script, Gmail, and a free Telegram bot for notifications. You list the companies or people you want to contact in a spreadsheet, and the tool fills in email content from fields you have already entered, with no AI involved in this version. It then creates a Gmail draft, but only for a row you have explicitly marked as verified and approved, so nothing goes out automatically without you checking it first. Once you approve sending, it tracks the sent date, the Gmail thread, and checks later for replies. It can also prepare and send a single follow-up email per contact once you approve that too, and it sends you Telegram alerts summarizing what happened. Safety is built in as a set of switches you control from a separate tab in the spreadsheet: a test mode that redirects everything to your own email address, a master switch that can block all sending, a daily limit on how many emails go out, and per-row checkboxes that require you to confirm an email address and approve each send individually. The whole thing runs automatically once an hour through a Google Apps Script trigger, and any errors are written back into the spreadsheet next to the row that caused them. Setting it up means creating a Google Sheet with two specific tabs, pasting the provided script into the sheet's built-in Apps Script editor, and following a written installation guide, ideally while running in test mode first. The author is explicit that this is meant for a small number of personalized, researched contacts, not for spam or mass emailing scraped lists. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through setting up this Google Sheet and Apps Script project from the installation guide.
Prompt 2
Explain what each safety gate, like TEST_MODE and AUTO_SEND_ENABLED, controls before I go live.
Prompt 3
Show me how to add the required tracker headers to my spreadsheet based on the spreadsheet specification.
Prompt 4
Help me set up the Telegram bot so I get alerts when this automation sends an email.

Frequently asked questions

What is outreach-automation-v1?

A Google Sheets and Apps Script tool that tracks and sends personal cold outreach emails, with manual approval required before anything is sent.

What language is outreach-automation-v1 written in?

Mainly JavaScript. The stack also includes JavaScript, Google Apps Script, Gmail.

What license does outreach-automation-v1 use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is outreach-automation-v1 to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is outreach-automation-v1 for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.