English Français العربية

Carbon Footprint Calculator

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع Carbon Footprint Calculator؟

  • 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package carbon-footprint-mcp
Claude Code 
claude mcp add carbon-footprint-calculator -- uvx carbon-footprint-mcp==1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "carbon-footprint-calculator": {
            "command": "uvx",
            "args": [
                "carbon-footprint-mcp==1.0.0"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Carbon Footprint Calculator (MCP Server)
  2. Why This Exists
  3. What It Does
  4. Emission Factor Source
  5. Installation
  6. Available MCP Tools
  7. Supported Emission Categories
  8. Carbon Intensity Scoring
  9. License
  10. Built By SlickBooks

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:
{
  "mcpServers": {
    "carbon-footprint": {
      "command": "uvx",
      "args": ["carbon-footprint-mcp"]
    }
  }
}
  1. Restart Claude Desktop.
Claude Code or Cursor
claude mcp add carbon-footprint -- uvx carbon-footprint-mcp
Local Development
git clone https://github.com/MayankTalwar0/carbon-footprint-mcp.git
cd carbon-footprint-mcp
pip 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.

الأسئلة الشائعة

ما هو Carbon Footprint Calculator؟

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

كيف أثبّت Carbon Footprint Calculator؟

يعمل على جهازك. في Claude Code: claude mcp add carbon-footprint-calculator -- uvx carbon-footprint-mcp==1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Carbon Footprint Calculator إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Carbon Footprint Calculator مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Carbon Footprint Calculator؟

ينشره MayankTalwar0. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.