Skip to content

Instantly share code, notes, and snippets.

Last active December 17, 2022 10:23
What would you like to do?
Copying data from Firebase Realtime Database to a Google Sheet in real time via Cloud Functions

Copying data from Firebase Realtime Database to a Google Sheet in real time via Cloud Functions

If you're trying to do this, you came to the right place!

Watch this code work in real time:

See also this gist for copying in the other direction:


  1. Follow step 1 to enable Google Sheets API in your Firebase project:

  2. Create a service account in your project; save the json file in the functions folder with the file name serviceAccount.json.

  3. Create a spreadsheet in Drive; rename the first worksheet 'Scores'; add Player and Score headers in row 1, columns A and B.

  4. Share it with edit access to the email address in your service account.

  5. Copy the spreadsheet id (from its URL) to the spreadsheetId string in the TypeScript source.

  6. npm install firebase-admin firebase-functions googleapis@34 lodash

  7. Deploy this (TypeScript) code.

  8. Update the keys/values in your database under /scores and watch them get updated in the sheet!

Helpful documentation

// Copyright 2017 Google LLC.
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// See the License for the specific language governing permissions and
// limitations under the License.
import * as functions from 'firebase-functions'
import * as _ from 'lodash'
import { google } from 'googleapis'
const sheets = google.sheets('v4')
const spreadsheetId = 'YOUR_SPREADSHEET_ID_HERE'
const serviceAccount = require('../serviceAccount.json')
const jwtClient = new google.auth.JWT({
email: serviceAccount.client_email,
key: serviceAccount.private_key,
scopes: [ '' ], // read and write sheets
const jwtAuthPromise = jwtClient.authorize()
type Scores = { string: number }
export const copyScoresToSheet = functions.database.ref('/scores').onUpdate(async change => {
const data: Scores = change.after.val()
// Sort the scores. scores is an array of arrays each containing name and score.
const scores =<Scores, [string, number]>(data, (value, key) => [key, value])
scores.sort((a,b) => { return b[1] - a[1] })
await jwtAuthPromise
await sheets.spreadsheets.values.update({
auth: jwtClient,
spreadsheetId: spreadsheetId,
range: 'Scores!A2:B7', // update this range of cells
valueInputOption: 'RAW',
requestBody: { values: scores }
}, {})
Copy link

loobeet commented Jul 22, 2022

Hi all, thanks for all these inputs. I succeeded to create an automatic sync with one database. I have a second data base with more than 26 columns, does anyone know how we can create a log to replicate the Google Sheets algorithm of range generation ?
Thanks a lot !

Copy link

Functions deploy had errors with the following functions:

I am getting this error while deploying the function. Here is my package.json

  "name": "functions",
  "description": "Cloud Functions for Firebase",
  "scripts": {
    "serve": "firebase emulators:start --only functions",
    "shell": "firebase functions:shell",
    "start": "npm run shell",
    "deploy": "firebase deploy --only functions",
    "logs": "firebase functions:log"
  "engines": {
    "node": "12"
  "main": "index.js",
  "dependencies": {
    "firebase-admin": "^9.8.0",
    "firebase-functions": "^3.14.1"
  "devDependencies": {
    "firebase-functions-test": "^0.2.0"
  "private": true

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment