# theoephraim/node-google-spreadsheet

Google Sheets API wrapper for Javascript / Typescript

Repository: https://github.com/theoephraim/node-google-spreadsheet
Canonical: https://ross.abutalabs.com/products/node-google-spreadsheet
Homepage: https://theoephraim.github.io/node-google-spreadsheet
Language: TypeScript
License: MIT
License Family: permissive
Topics: google-spreadsheets, nodejs, google, google-sheets, google-sheets-api-v4, typescript
Last push: 2026-06-03T22:07:53+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 85, release rhythm 87, longevity 100
- inputs: {"age_days": 4930, "days_push": 91, "days_rel": 91, "gap_med": 24, "n_releases_24m": 8}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2489, forks 388 (observed 2026-08-28T04:06:55.734546+00:00)

## What it is
A popular JavaScript/TypeScript wrapper library for the Google Sheets API (v4). It provides cell-based and row-based read/write operations, worksheet and document management, export, and multiple auth options with automatic retries.

## Use cases
- read and write google sheets from node.js
- use a google sheet as a database or cms
- bulk update spreadsheet cells via api
- manage worksheets and share google docs programmatically
- export google sheets to csv or other formats
- authenticate to google sheets with a service account

## When to choose
- you want a friendly, typed interface over the raw Google Sheets API in Node.js
- you need row-based CRUD operations on spreadsheet data
- you want built-in retries and rate-limit handling for Sheets API calls

## When to avoid
- you are not working in a JavaScript/TypeScript runtime
- you need real-time streaming updates from Sheets (use the Google Apps Script or Push API instead)
- you need heavy spreadsheet computation - use a spreadsheet engine instead

## Facets
- artifact type: library
- maturity: active
- function: sdk, http-client, auth
- domain: apis, developer-tools
- platform: -
- tags: google-sheets, google-sheets-api-v4, spreadsheet, api-wrapper, google-api, data-engineering, nodejs, typescript, javascript

## Member repositories
- theoephraim/node-google-spreadsheet (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:55.734546+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-30T02:27:50.888637+00:00, confidence not recorded.
  - readme: https://github.com/theoephraim/node-google-spreadsheet (fetched 2026-08-28T04:06:55.734546+00:00, sha b67b3f02361a)
  - homepage: https://theoephraim.github.io/node-google-spreadsheet (fetched 2026-08-29T10:09:45.425529+00:00, sha a8d26caad40d)
- Data as of 2026-08-30T08:39:29.467469+00:00.