An MCP server for calculating carbon footprints from bank statements using EPA GHG emission factors.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"carbon-footprint": {
"args": [
"carbon-footprint-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'carbon-footprint-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked carbon-footprint-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in other
Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.
Autonomous spec-to-product coding-agent CLI with an MCP server exposing 34 tools over stdio.
97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server
App framework, testing framework, and inspector for MCP Apps.
MCP Security Weekly
Get CVE alerts and security updates for io.github.MayankTalwar0/carbon-footprint-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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
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.
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.
uv.{
"mcpServers": {
"carbon-footprint": {
"command": "uvx",
"args": ["carbon-footprint-mcp"]
}
}
}
claude mcp add carbon-footprint -- uvx carbon-footprint-mcp
git clone https://github.com/MayankTalwar0/carbon-footprint-mcp.git
cd carbon-footprint-mcp
pip install -e .
carbon-footprint-mcp
| Tool | Description |
|---|---|
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. |
| Scope | Category | Input Required |
|---|---|---|
| 1 | Stationary Combustion | Fuel type and quantity |
| 1 | Mobile Combustion | Fuel type and gallons |
| 1 | Refrigerant Leakage | Gas type, leaked kg, and GWP |
| 2 | Purchased Electricity | kWh and eGRID subregion |
| 2 | Purchased Steam or Heat | mmBtu |
| 3 | Transportation and Distribution | Vehicle type and distance |
| 3 | Waste Disposal | Material, short tons, and disposal method |
| 3 | Business Travel | Travel mode and passenger-miles |
| 3 | Employee Commuting | Commute mode and passenger-miles |
| Score | tCO2e per $1M Revenue | Interpretation |
|---|---|---|
| Excellent | < 5 | Best-in-class for low-footprint operations |
| Good | 5-20 | Low intensity |
| Moderate | 20-100 | Typical for services and tech |
| High | 100-500 | Heavy operations |
| Very High | > 500 | Very high intensity |
MIT
Built by