
A Model Context Protocol (MCP) server for accessing the Climatiq API to calculate carbon emissions.
A Model Context Protocol (MCP) server for accessing the Climatiq API to calculate carbon emissions. This allows AI assistants to perform real-time carbon calculations and provide climate impact insights.
·
A Model Context Protocol (MCP) server for accessing the Climatiq API to calculate carbon emissions. This allows AI assistants to perform real-time carbon calculations and provide climate impact insights.
https://github.com/user-attachments/assets/c253d6d1-ccf6-4c14-965e-6023ba2a0296
https://github.com/user-attachments/assets/d61c1181-acf6-4d9f-9a48-537fc64ac4c3
This MCP server integrates with the Climatiq API to provide carbon emission calculations for AI assistants:
climatiq://calculation/{id} URI schemeThis project uses uv for virtual environment and dependency management. Make sure to install uv first.
# Clone the repository
git clone https://github.com/your-org/climatiq-mcp-server.git
cd climatiq-mcp-server
# Create a virtual environment
uv venv
# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate
# Install dependencies with development extras
uv sync --dev --extra alluv pip install climatiq-mcp-serverThe server requires a Climatiq API key to function. You have several options to provide it:
Environment Variable: Set the CLIMATIQ_API_KEY environment variable before starting the server
export CLIMATIQ_API_KEY=your_climatiq_api_keyConfiguration During Installation:
CLIMATIQ_API_KEY=your_climatiq_api_key uv pip install climatiq-mcp-serverset-api-key Tool: Use the set-api-key tool to configure it during runtime within the AI assistant
Configuration File: Create a .env file in the project directory:
CLIMATIQ_API_KEY=your_climatiq_api_keyTo get a Climatiq API key:
The server can be started directly from the command line:
climatiq-mcp-serverOn MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
"mcpServers": {
"climatiq-mcp-server": {
"command": "climatiq-mcp-server",
"env": {
"CLIMATIQ_API_KEY": "your_climatiq_api_key"
}
}
}The examples/ directory contains:
# Run the simple test
python examples/simple_test.pyThe utils/ directory contains several helpful scripts:
The test_client.py script tests all the tools, prompts, and resources:
python utils/test_client.pyThe llm_example_client.py script demonstrates how a Large Language Model (like Claude) could interact with the Climatiq MCP server:
python utils/llm_example_client.pyKey features:
A command-line interface tool for direct API access without the MCP server complexity:
# For electricity emissions
python utils/climatiq_cli.py electricity --energy 1000 --unit kWh --region US
# For travel emissions
python utils/climatiq_cli.py travel --mode car --distance 100 --unit km --region USUse the run_mcp_server.py script to directly run the server without installing:
python utils/run_mcp_server.pyAn Activity ID is a key concept in Climatiq's API that groups similar emission factors together:
electricity-supply_grid-source_residual_mix (electricity), passenger_vehicle-vehicle_type_car (car travel)The Climatiq MCP server supports multiple calculation methods:
CLIMATIQ_API_KEY is set correctly in your environment or .env fileexamples/simple_test.py to check if your API key works correctlyFor detailed documentation on using specific tools and advanced features, see the docs/README.md file.
Climatiq provides a powerful API for carbon intelligence, allowing you to calculate emissions from electricity usage, transportation, procurement, and more. This MCP server makes those capabilities accessible to AI assistants through the Model Context Protocol.
For more information about Climatiq, visit climatiq.io.
This project is licensed under the MIT License - see the LICENSE file for details.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add climatiq-mcp-server -- climatiq-mcp-server{
"mcpServers": {
"climatiq-mcp-server": {
"env": {
"CLIMATIQ_API_KEY": ""
},
"command": "climatiq-mcp-server"
}
}
}code --add-mcp '{"name":"climatiq-mcp-server","env":{"CLIMATIQ_API_KEY":""},"command":"climatiq-mcp-server"}'[mcp_servers.climatiq-mcp-server]
command = "climatiq-mcp-server"Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/climatiq-mcp-server to learn what the "Climatiq MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
uv pip install climatiq-mcp-serverThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/climatiq-mcp-server)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "climatiq-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.