# KartikTalwar/gmail.js

Gmail JavaScript API

Repository: https://github.com/KartikTalwar/gmail.js
Canonical: https://ross.abutalabs.com/products/gmailjs
Language: JavaScript
License: MIT
License Family: permissive
Topics: javascript, chrome-extension, gmail
Last push: 2026-08-04T09:31:47+00:00

## Health v2 (maintenance only)
Score: 75/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 35, longevity 100
- inputs: {"age_days": 4733, "days_push": 29, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3842, forks 454 (observed 2026-08-28T04:08:24.017667+00:00)

## What it is
Gmail.js is a JavaScript library that provides an unofficial API for interacting with Gmail's web interface from browser extensions. It lets WebExtension developers read email data and observe Gmail events by injecting into the Gmail DOM, without needing OAuth.

## Use cases
- build a chrome extension that reads gmail emails
- observe when user composes or sends email in gmail
- extract email metadata from gmail web ui
- automate actions inside gmail via browser extension
- add custom toolbar buttons to gmail interface
- react to gmail events without oauth

## When to choose
- you are building a WebExtension (Chrome/Firefox) that enhances Gmail
- you want email data or event hooks without OAuth setup
- you need DOM and data access to the Gmail web client

## When to avoid
- you need server-side access to Gmail from Node.js
- you are building a standalone web app talking to Gmail
- you need an official, Google-supported API with stability guarantees

## Facets
- artifact type: library
- maturity: active
- function: sdk, browser-extension, email, web-scraping
- domain: email, browser-extensions, web-development, developer-tools
- platform: browser, browser-extension
- tags: gmail, webextension, content-script, dom-scraping, jquery, unofficial-api, javascript, nodejs

## Member repositories
- KartikTalwar/gmail.js (main) score 75

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:24.017667+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:26:12.910596+00:00, confidence not recorded.
  - readme: https://github.com/KartikTalwar/gmail.js (fetched 2026-08-28T04:08:24.017667+00:00, sha 0ea7b184c2e2)
- Data as of 2026-08-30T08:39:29.467469+00:00.