Open Source • 967 Factors • Zero API Costs

Carbon intelligence
for every scope

Calculate greenhouse gas emissions across Scope 1, 2, and 3 with 967 embedded emission factors from 6 peer-reviewed databases. CLI, MCP server, and Claude Code skill.

Get Started View on GitHub
967
Emission Factors
6
Databases
120
Countries
92
Tests Passing

Up and running in 60 seconds

Three steps. No API keys, no accounts, no subscriptions.

01

Clone and install

Requires Python 3.11+ and uv.

# Clone the repo
git clone https://github.com/gaiaaiagent/ghg-calculator.git
cd ghg-calculator
uv sync
02

Calculate emissions

Run your first calculation from the CLI.

# 1,000 therms of natural gas
uv run ghg calculate \
  --scope 1 \
  --category stationary_combustion \
  --fuel natural_gas \
  --quantity 1000 --unit therm

# → 5,307 kg CO2e (5.3 tCO2e)
03

Install the Claude skill

Use natural language to analyze any scenario.

# Install globally
cp -r .claude/skills/ghg-analyze \
  ~/.claude/skills/

One command. Full inventory.

The /ghg-analyze skill researches real data, builds activity records, calculates across all scopes, and generates interactive reports.

/ghg-analyze hyperscaler data center buildout in Texas 2025
Researches Stargate, Meta, Google, Microsoft, AWS campuses — calculates 11.8 MtCO2e across ~3.8 GW
/ghg-analyze my company's 200-truck diesel fleet in Ohio
Models fuel consumption, maintenance, tire wear — full Scope 1 + 3 inventory with fleet-level report
/ghg-analyze Bitcoin mining operation 50MW in Iceland
Uses Ember factors for Iceland's grid (near-zero carbon), models cooling, equipment embodied carbon
/ghg-analyze semiconductor fab construction in Arizona
Construction materials, process gases, AZNM grid electricity, supply chain spend-based estimates

Everything you need

◉

All 3 Scopes

Scope 1 direct combustion and fugitive emissions. Scope 2 with dual location + market-based. All 15 Scope 3 categories.

◈

Per-Gas Breakdown

CO2, CH4, N2O calculated separately and converted via GWP (AR5/AR6). Full transparency on every calculation.

◆

Interactive Reports

Geographic maps, scope donuts, waterfall charts, treemaps, top sources — dark theme with Plotly.

⊞

MCP Server

8 tools for AI agent integration. Give any MCP-compatible client access to emissions calculations.

▷

CLI

6 commands: calculate, factors, gwp, convert, validate, report. Rich terminal output with formatted tables.

◯

Offline & Free

All 967 factors embedded as versioned JSON. No API keys, no rate limits, no costs. MIT licensed.

967 factors from 6 databases

113
EPA Hub
US combustion + refrigerants
122
eGRID
US electricity, 27 subregions
117
DEFRA
UK/intl transport + materials
264
USEEIO
US spend-based by NAICS
120
Ember
120 countries electricity
231
EXIOBASE
Multi-regional input-output

Start calculating

Clone the repo, install the skill, and run your first emissions analysis in under a minute.

git clone https://github.com/gaiaaiagent/ghg-calculator.git && cd ghg-calculator && uv sync
View on GitHub Follow @reslashacc