Carbon Footprint Calculator

io.github.MayankTalwar0Published by GitHub account MayankTalwar0v1.0.1Updated Oct 24, 2026

An MCP server for calculating carbon footprints from bank statements using EPA GHG emission factors.

The publisher's own server: Carbon Fyi

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Calculates organizational carbon footprints from bank statements and activity data using EPA emission factors, and generates HTML and Markdown reports.

What you can do
Ingests bank CSVs, Xero or QBO exports, and structured activity data, then helps categorize transactions into likely emission sources such as electricity, fuel, travel, shipping, and waste. It computes Scope 1, Scope 2, and Scope 3 emissions using EPA GHG emission factors, scores carbon intensity by revenue and headcount when provided, and renders polished HTML and Markdown reports. Tools include computeEmissions, generateEmissionsReport, and listEmissionFactors.
When to use it
Useful when preparing ESG reporting, investor diligence materials, or internal sustainability reviews and you want to turn raw financial exports and operational inputs into an emissions baseline quickly. It suits organizations that already have bank or accounting exports and want EPA-aligned factor calculations without manual spreadsheet work.
Requirements
Runs locally as a stdio process, installed via uvx from the PyPI package carbon-footprint-mcp (uv required; Python for local development). No authentication, environment variables, or headers are declared. Works with Claude Desktop, Claude Code, Cursor, and other MCP clients.
Before you install
The server reads financial data such as bank statements and accounting exports, so review what you feed it even though it states it runs locally, sends no financial data to external APIs, and stores no data by default. generateEmissionsReport writes report files to a directory you specify. Emission factors are EPA-based, and electricity benchmarking uses EPA eGRID regional factors, which may not match non-US operations.

Installation

In SourceWeft

  1. Open Carbon Footprint Calculator in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Carbon Footprint Calculator (MCP Server)

An MCP (Model Context Protocol) server for calculating organizational carbon footprints from bank statements, financial exports, and structured activity data using EPA GHG emission factors.

Privacy and security first

  • Runs 100% locally on your machine or server
  • Sends no financial data to external APIs or cloud providers
  • Stores no data by default
  • Exposes read-only calculation and reporting tools
  • Works with Claude Desktop, Cursor, and other MCP clients

Why This Exists

If you are preparing ESG reporting, investor diligence materials, or internal sustainability reviews, getting to a usable emissions baseline is usually slow and manual.

This server helps turn raw bank statements, Xero or QBO exports, and structured operational inputs into a carbon footprint report in minutes. It maps activities to EPA-aligned emission factors and produces both HTML and Markdown outputs.

The user experience is designed to work for organizations in any country, while the current electricity benchmarking still uses EPA eGRID regional factors under the hood.

What It Does

  1. Ingests bank CSVs, Xero or QBO exports, and structured activity data.
  2. Helps categorize transactions into likely emission sources such as electricity, fuel, travel, shipping, and waste.
  3. Computes Scope 1, Scope 2, and Scope 3 emissions using EPA GHG emission factors.
  4. Scores carbon intensity by revenue and headcount when those inputs are provided.
  5. Generates polished HTML and Markdown reports.

Emission Factor Source

All emission factors are based on the EPA GHG Emission Factors Hub (January 2025), including eGRID 2023 electricity factors and IPCC AR5 global warming potentials.

Covered categories include stationary combustion, mobile combustion, electricity, steam or heat, transportation, waste disposal, business travel, employee commuting, and refrigerants.

Installation

Claude Desktop

  1. Install uv.
  2. Open Claude Desktop settings and edit the MCP config.
  3. Add this server:
json
{  "mcpServers": {    "carbon-footprint": {      "command": "uvx",      "args": ["carbon-footprint-mcp"]    }  }}
  1. Restart Claude Desktop.

Claude Code or Cursor

bash
claude mcp add carbon-footprint -- uvx carbon-footprint-mcp

Local Development

bash
git clone https://github.com/MayankTalwar0/carbon-footprint-mcp.gitcd carbon-footprint-mcppip install -e .carbon-footprint-mcp

Available MCP Tools

ToolDescription
computeEmissions(inputs_json)Computes GHG emissions from structured activity data across all 3 scopes.
generateEmissionsReport(emissions_json, output_dir)Renders a polished HTML and Markdown report and saves it to disk.
listEmissionFactors(category)Lists available fuel, eGRID, and waste emission factors.

Supported Emission Categories

ScopeCategoryInput Required
1Stationary CombustionFuel type and quantity
1Mobile CombustionFuel type and gallons
1Refrigerant LeakageGas type, leaked kg, and GWP
2Purchased ElectricitykWh and eGRID subregion
2Purchased Steam or HeatmmBtu
3Transportation and DistributionVehicle type and distance
3Waste DisposalMaterial, short tons, and disposal method
3Business TravelTravel mode and passenger-miles
3Employee CommutingCommute mode and passenger-miles

Carbon Intensity Scoring

ScoretCO2e per $1M RevenueInterpretation
Excellent< 5Best-in-class for low-footprint operations
Good5-20Low intensity
Moderate20-100Typical for services and tech
High100-500Heavy operations
Very High> 500Very high intensity

License

MIT

Built By SlickBooks

Built by Mayank, founder of SlickBooks.

Source: README.md at commit 3faba70

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Carbon integrations