Integrates with Xero to ingest financial exports for calculating organizational carbon footprints, mapping activities to EPA emission factors and generating reports.
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.
Related MCP server: carbonstop-mcp
Ingests bank CSVs, Xero or QBO exports, and structured activity data.
Helps categorize transactions into likely emission sources such as electricity, fuel, travel, shipping, and waste.
Computes Scope 1, Scope 2, and Scope 3 emissions using EPA GHG emission factors.
Scores carbon intensity by revenue and headcount when those inputs are provided.
Generates polished HTML and Markdown reports.
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.
Install uv.
Open Claude Desktop settings and edit the MCP config.
Add this server:
{
"mcpServers": {
"carbon-footprint": {
"command": "uvx",
"args": ["carbon-footprint-mcp"]
}
}
}Restart Claude Desktop.
claude mcp add carbon-footprint -- uvx carbon-footprint-mcpgit clone https://github.com/MayankTalwar0/carbon-footprint-mcp.git
cd carbon-footprint-mcp
pip install -e .
carbon-footprint-mcpTool | Description |
| Computes GHG emissions from structured activity data across all 3 scopes. |
| Renders a polished HTML and Markdown report and saves it to disk. |
| 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 Mayank, founder of SlickBooks.
Computes greenhouse gas emissions from structured activity data.
IMPORTANT: After calling this tool, you MUST call generateEmissionsReport with the
full output of this tool. Do not present results to the user without first saving
the report files. The _required_next_step field in the response will remind you.
Args:
inputs_json: A JSON string containing categorized activity data.
Required fields vary by scope:
- Scope 1: stationary_combustion, mobile_combustion, refrigerants
- Scope 2: electricity_kwh, egrid_subregion, steam_mmbtu
- Scope 3: business_travel, employee_commuting, transportation, waste
Optional: annual_revenue, headcount (for scoring), period, source
Returns:
JSON string containing computed emissions by scope, totals, breakdown,
carbon intensity scores, and a _required_next_step instruction.
Inputs: inputs_json (required). Returns: result
Generates a carbon footprint report in HTML + Markdown and saves to disk.
Args:
emissions_json: JSON string - the direct output from computeEmissions.
output_dir: Directory to save reports to. Default is current directory.
Returns:
JSON with paths to both report files and the markdown content inline.
Inputs: emissions_json (required), output_dir. Returns: result
Lists available emission factors for reference.
Args:
category: One of 'fuels', 'egrid', 'waste', or 'all'.
Returns:
JSON string listing available factors.
Inputs: category. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 3 tools
Each tool has a clear, distinct purpose: computing emissions, generating reports, and listing emission factors. No functional overlap exists.
All tool names follow a consistent camelCase verb_noun pattern: computeEmissions, generateEmissionsReport, listEmissionFactors.
Three tools is appropriate for a focused carbon footprint calculator, covering computation, reporting, and reference without being too few or too many.
The tool set covers core workflow steps (compute, report, reference). Minor gaps like update/delete for reports or scenario comparison are not essential for the core purpose.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
TaxSort — Tollbooth-monetized MCP server for personal tax transaction classification
MCP server for Modern Treasury — payment orders, transactions, counterparties and ledgers.
A MCP server for the Frankfurter API for currency exchange rates.
