← Back to Skills Marketplace
mhmalvi

Google Sheets Reporting

by Muhammad H.M. Alvi · GitHub ↗ · v1.0.1
linuxdarwinwin32 ✓ Security Clean
368
Downloads
0
Stars
2
Active Installs
2
Versions
Install in OpenClaw
/install google-sheets-reporting
Description
Automated reporting and alerts from Google Sheets data. Daily summaries with auto-detected metrics, configurable threshold alerts, and weekly multi-sheet dig...
README (SKILL.md)

Google Sheets Reporting

Automated reporting and alerting from any Google Sheets data. Get daily summaries, threshold-based alerts, and weekly digest emails without building dashboards.

Problem

Teams store operational data in Google Sheets but lack automated reporting. Checking sheets manually is tedious, and important changes (threshold violations, trends) go unnoticed until it's too late.

This skill turns any Google Sheet into an automated reporting system with zero code changes.

What It Does

  1. Daily Summary — Auto-detects numeric columns, calculates sum/avg/min/max, emails formatted report
  2. Threshold Alerts — Checks values against configurable min/max thresholds hourly, sends alert emails when violated
  3. Weekly Digest — Multi-sheet summary every Monday with period-over-period comparison

Included Workflows

# File Purpose
01 01-daily-summary.json Daily aggregate statistics email for any sheet
02 02-threshold-alerts.json Hourly threshold monitoring with alert emails
03 03-weekly-digest.json Weekly multi-sheet digest email (Monday 9AM)

Architecture

Daily (once):
    |
    v
Workflow 01: Daily Summary
    +-> Read sheet data
    +-> Auto-detect numeric columns
    +-> Calculate sum, avg, min, max
    +-> Count categories in first text column
    +-> Email formatted report

Hourly:
    |
    v
Workflow 02: Threshold Alerts
    +-> Read sheet data
    +-> Check each value against thresholds
    +-> IF violations found -> email alert
    +-> Thresholds configurable via env variable

Weekly (Monday 9AM):
    |
    v
Workflow 03: Weekly Digest
    +-> Read primary + secondary sheets in parallel
    +-> Summarize both sheets
    +-> Email combined digest

Required n8n Credentials

Credential Type Used For Placeholder in JSON
Google Sheets OAuth2 Reading sheet data YOUR_GOOGLE_SHEETS_CREDENTIAL_ID
SMTP Sending reports and alerts YOUR_SMTP_CREDENTIAL_ID

Configuration Placeholders

Placeholder Description
YOUR_REPORT_SHEET_ID Google Sheet ID to monitor
YOUR_GOOGLE_SHEETS_CREDENTIAL_ID n8n Google Sheets credential ID
YOUR_SMTP_CREDENTIAL_ID n8n SMTP credential ID
YOUR_NOTIFICATION_EMAIL Email for reports and alerts

Environment Variables

# Required
[email protected]

# Optional: Threshold configuration (JSON)
ALERT_THRESHOLDS='{"revenue":{"min":100,"max":null,"label":"Revenue"},"error_count":{"min":null,"max":10,"label":"Errors"}}'

Threshold Configuration

Thresholds are configured via the ALERT_THRESHOLDS environment variable as JSON:

{
  "column_name": {
    "min": 100,
    "max": null,
    "label": "Display Name"
  }
}
  • min — Alert if value falls below this (set null to disable)
  • max — Alert if value exceeds this (set null to disable)
  • label — Human-readable name for alert emails

Quick Start

1. Prerequisites

  • n8n v2.4+ (self-hosted)
  • Google Sheets OAuth2 credentials
  • SMTP email credentials
  • A Google Sheet with data (any structure works)

2. Import & Configure

Import all 3 JSON files into n8n. Replace YOUR_REPORT_SHEET_ID with your sheet's ID and set credential placeholders.

3. Customize Sheet Names

Edit the Google Sheets nodes to match your tab names (default: "Data" and "Sheet2").

4. Set Thresholds

Configure ALERT_THRESHOLDS env var for your columns, or edit the Code node defaults directly.

5. Activate

Activate all 3 workflows. You'll receive your first daily summary within 24 hours.

Use Cases

  1. Sales teams — Daily revenue summaries and low-sales alerts from order sheets
  2. Support teams — Ticket count monitoring with escalation alerts
  3. Marketing — Campaign performance digests from tracking sheets
  4. Operations — Inventory level alerts and daily status reports
  5. Finance — Expense monitoring with budget threshold alerts

Requirements

  • n8n v2.4+ (self-hosted or cloud)
  • Google Sheets OAuth2 credentials
  • SMTP email credentials
Usage Guidance
This skill appears to be what it says: it reads Google Sheets and emails formatted reports/alerts. Before installing: 1) Confirm the REPORT_EMAIL recipient is correct and safe (alerts may include snippets of row data). 2) Use minimal-permission Google credentials (restrict to the specific Sheet) and an SMTP account dedicated to automated reports. 3) Review and set ALERT_THRESHOLDS to avoid noisy alerts and to ensure numeric column names match your sheet. 4) Inspect the workflows in your n8n instance and test on a non-production sheet to verify no sensitive fields are included in alert emails. 5) Note minor metadata inconsistencies (owner/version fields differ across files); this is not a security issue by itself but worth verifying the source if you require provenance.
Capability Analysis
Type: OpenClaw Skill Name: google-sheets-reporting Version: 1.0.1 The OpenClaw skill 'google-sheets-reporting' is designed for automated reporting and alerting from Google Sheets data. All actions, including reading from Google Sheets and sending emails via SMTP, are explicitly declared, align with the stated purpose, and require user-configured credentials and environment variables. The JavaScript code in the n8n workflows processes user-provided sheet data to generate summaries and alerts, without any evidence of intentional harmful behavior such as data exfiltration to unauthorized endpoints, malicious execution, persistence mechanisms, or prompt injection attempts against the agent. Potential vulnerabilities like XSS in generated HTML or `JSON.parse` on environment variables are within the context of user-configured data and parameters, not indicative of malicious intent by the skill author.
Capability Assessment
Purpose & Capability
Name/description (Google Sheets reporting) align with what the workflows do: read sheets via Google OAuth2, compute aggregates/threshold checks in n8n Code nodes, and send email via SMTP. Required credentials (Google Sheets OAuth2, SMTP) and env vars (REPORT_EMAIL, ALERT_THRESHOLDS) are appropriate for this purpose.
Instruction Scope
Instructions and workflow code stay within scope (read sheet rows, compute stats, build HTML, email results). Note: the workflows include entire row content in alert row identifiers (JSON.stringify(row).slice(0,50)), so alert emails may contain portions of row data (possibly sensitive). Review which sheet columns are monitored and who receives REPORT_EMAIL.
Install Mechanism
No install spec or external downloads — instruction-only skill and three n8n workflow JSONs. Nothing is written or fetched at install time.
Credentials
Only two env vars are requested: REPORT_EMAIL (recipient) and ALERT_THRESHOLDS (threshold JSON). The workflows also require n8n credentials for Google Sheets and SMTP, which are reasonable. No unrelated secrets or system paths are requested.
Persistence & Privilege
Skill is not always-enabled and does not request elevated platform privileges. It schedules recurring runs within n8n (the workflows are cron/schedule-based), which is expected behavior.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install google-sheets-reporting
  3. After installation, invoke the skill by name or use /google-sheets-reporting
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Fix: declare all env vars used in workflows in requires.env metadata for security scan compliance
v1.0.0
- Initial release of google-sheets-reporting skill for automated reporting and alerts from Google Sheets. - Provides daily numeric summaries, configurable threshold alerts (hourly), and weekly digest emails. - Includes three production-ready n8n workflows for summary, alerting, and multi-sheet digests. - Customizable via environment variables and supports multiple use cases (sales, support, marketing, operations). - Requires n8n v2.4+, Google Sheets OAuth2 credentials, and SMTP credentials.
Metadata
Slug google-sheets-reporting
Version 1.0.1
License
All-time Installs 2
Active Installs 2
Total Versions 2
Frequently Asked Questions

What is Google Sheets Reporting?

Automated reporting and alerts from Google Sheets data. Daily summaries with auto-detected metrics, configurable threshold alerts, and weekly multi-sheet dig... It is an AI Agent Skill for Claude Code / OpenClaw, with 368 downloads so far.

How do I install Google Sheets Reporting?

Run "/install google-sheets-reporting" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Google Sheets Reporting free?

Yes, Google Sheets Reporting is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Google Sheets Reporting support?

Google Sheets Reporting is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux, darwin, win32).

Who created Google Sheets Reporting?

It is built and maintained by Muhammad H.M. Alvi (@mhmalvi); the current version is v1.0.1.

💬 Comments