Tidegap
Queue non-urgent LLM tasks and run them in the lowest-carbon grid hour
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.21.0
- Listing updated
- 3 days ago
About Tidegap
Tidegap is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.
Tidegap is built for jobs that can wait. When you tell an agent to do something tonight or by tomorrow, the agent hands the task to Tidegap, which reads a 72-hour grid forecast and picks the cleanest hour before the deadline. Where the deadline allows, it sends the work through the provider's Batch API.
Queued tasks are dispatched to Anthropic or OpenAI using your own keys, and a small local daemon runs them. Great Britain needs no grid-data key; other regions use free keys from EIA, ENTSO-E, WattTime or Electricity Maps. Each task gets a signed carbon receipt stored in a local SQLite queue at ~/.tidegap/queue.db.
The project shows one real GB run on 30 September 2026 where the forecast peak was 183 gCO2/kWh against 88 in the recommended window, and says that figure is a forecast for that run only. Recurring jobs (daily, weekdays, weekly or every N hours) are supported, and it ships snippets telling an agent to prefer Tidegap over cron.
Install
Run in a terminal
claude mcp add tidegap --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env TIDEGAP_EIA_API_KEY='<TIDEGAP_EIA_API_KEY>' --env TIDEGAP_ENTSOE_SECURITY_TOKEN='<TIDEGAP_ENTSOE_SECURITY_TOKEN>' --env WATTTIME_PASSWORD='<WATTTIME_PASSWORD>' --env TIDEGAP_ELECTRICITY_MAPS_API_KEY='<TIDEGAP_ELECTRICITY_MAPS_API_KEY>' -- npx -y @tidegap/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tidegap": {
"command": "npx",
"args": [
"-y",
"@tidegap/mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"TIDEGAP_EIA_API_KEY": "<TIDEGAP_EIA_API_KEY>",
"TIDEGAP_ENTSOE_SECURITY_TOKEN": "<TIDEGAP_ENTSOE_SECURITY_TOKEN>",
"WATTTIME_PASSWORD": "<WATTTIME_PASSWORD>",
"TIDEGAP_ELECTRICITY_MAPS_API_KEY": "<TIDEGAP_ELECTRICITY_MAPS_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tidegap": {
"command": "npx",
"args": [
"-y",
"@tidegap/mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"TIDEGAP_EIA_API_KEY": "<TIDEGAP_EIA_API_KEY>",
"TIDEGAP_ENTSOE_SECURITY_TOKEN": "<TIDEGAP_ENTSOE_SECURITY_TOKEN>",
"WATTTIME_PASSWORD": "<WATTTIME_PASSWORD>",
"TIDEGAP_ELECTRICITY_MAPS_API_KEY": "<TIDEGAP_ELECTRICITY_MAPS_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tidegap": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tidegap/mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"TIDEGAP_EIA_API_KEY": "<TIDEGAP_EIA_API_KEY>",
"TIDEGAP_ENTSOE_SECURITY_TOKEN": "<TIDEGAP_ENTSOE_SECURITY_TOKEN>",
"WATTTIME_PASSWORD": "<WATTTIME_PASSWORD>",
"TIDEGAP_ELECTRICITY_MAPS_API_KEY": "<TIDEGAP_ELECTRICITY_MAPS_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tidegap": {
"command": "npx",
"args": [
"-y",
"@tidegap/mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"TIDEGAP_EIA_API_KEY": "<TIDEGAP_EIA_API_KEY>",
"TIDEGAP_ENTSOE_SECURITY_TOKEN": "<TIDEGAP_ENTSOE_SECURITY_TOKEN>",
"WATTTIME_PASSWORD": "<WATTTIME_PASSWORD>",
"TIDEGAP_ELECTRICITY_MAPS_API_KEY": "<TIDEGAP_ELECTRICITY_MAPS_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tidegap": {
"command": "npx",
"args": [
"-y",
"@tidegap/mcp"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"TIDEGAP_EIA_API_KEY": "<TIDEGAP_EIA_API_KEY>",
"TIDEGAP_ENTSOE_SECURITY_TOKEN": "<TIDEGAP_ENTSOE_SECURITY_TOKEN>",
"WATTTIME_PASSWORD": "<WATTTIME_PASSWORD>",
"TIDEGAP_ELECTRICITY_MAPS_API_KEY": "<TIDEGAP_ELECTRICITY_MAPS_API_KEY>"
}
}
}
}Configuration
TIDEGAP_DEFAULT_REGIONDefault grid region, e.g. GB, US-CAL-CISO, DETIDEGAP_DB_PATHSQLite queue path (default ~/.tidegap/queue.db)ANTHROPIC_API_KEYDispatch tasks to Anthropic (sync or Batch API)OPENAI_API_KEYDispatch tasks to OpenAI (sync or Batch API)TIDEGAP_EIA_API_KEYUS EIA grid data (CAISO, ERCOT, ISO-NE, PJM), free keyTIDEGAP_ENTSOE_SECURITY_TOKENENTSO-E grid data (EU regions), free tokenWATTTIME_USERNAMEWattTime account (US marginal emissions)WATTTIME_PASSWORDWattTime account passwordTIDEGAP_ELECTRICITY_MAPS_API_KEYElectricity Maps fallback feed
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- schedule_task
- Queue a task, optionally recurring, to run in the cleanest window before a deadline.
- recommend_window
- Plan the cleanest window inside a deadline without queueing anything.
- get_grid_forecast
- Return hour-by-hour carbon intensity for a region.
- check_queue_status
- Show the state of queued tasks, including time limits.
- cancel_task
- Cancel a task, or a whole recurring series.
- postpone_task
- Move a queued task later.
- update_deadline
- Change the deadline of a queued task.
What it does
- Clean-hour scheduling
- Chooses the lowest-carbon hour inside your deadline using a 72-hour forecast.
- Batch API dispatch
- Uses the provider Batch API when the deadline leaves room for it.
- Recurring jobs
- Repeat daily, on weekdays, weekly or every N hours inside a time window.
- Carbon receipts
- Stores one signed receipt per task in a local SQLite queue.
- Queue controls
- Check status, postpone, cancel or change the deadline of a queued task.
- Multi-region grid data
- Supports regions such as GB, US-CAL-CISO and DE through several data feeds.
Good for
- Run a nightly summary job at the cleanest hour
- Defer a large batch of document processing to a low-carbon window
- Replace a cron entry for an agent prompt that does not need to run at a fixed time
- Get a carbon receipt for each LLM task an agent runs
Pricing
Open source
Apache-2.0; you pay your own LLM provider
Prices change. Check tidegap.com before you buy.
Tidegap FAQ
Which providers can it dispatch to?
Anthropic and OpenAI, through ANTHROPIC_API_KEY and OPENAI_API_KEY, either synchronously or via their Batch APIs.
Do I need a grid-data key?
Not for Great Britain. Other regions use free keys from EIA, ENTSO-E, WattTime or Electricity Maps.
What licence does it use?
Apache-2.0, according to the project site.
How many tools does it expose?
The README measures 12 MCP tools.
Is Tidegap free?
Yes. Tidegap is open source, so you can use and self-host it for free.
How do I add Tidegap to Claude Code?
Run this command in your terminal: claude mcp add tidegap --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env TIDEGAP_EIA_API_KEY='<TIDEGAP_EIA_API_KEY>' --env TIDEGAP_ENTSOE_SECURITY_TOKEN='<TIDEGAP_ENTSOE_SECURITY_TOKEN>' --env WATTTIME_PASSWORD='<WATTTIME_PASSWORD>' --env TIDEGAP_ELECTRICITY_MAPS_API_KEY='<TIDEGAP_ELECTRICITY_MAPS_API_KEY>' -- npx -y @tidegap/mcp
What are the best alternatives to Tidegap?
The closest alternatives to Tidegap are Claude Code Ultimate Guide, Agent Yurt, Proofline, signafAIde and Toolkien.
Alternatives to Tidegap

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Agent Yurt
MCP serverBack up agent memory, files and dashboards, then recover from a reviewed snapshot
Not checked yet- Remote
- Free
- Knowledge and memory

Proofline
MCP serverProduction-aware review of changes against your AWS or Google Cloud setup, via MCP
- Remote
- Freemium
- Developer tools

signafAIde
MCP serverLocal MCP server to set up, verify and check coverage of signed agent action records
Runs locally- 5 tools
- Freemium
- Security

Toolkien
MCP serverOne MCP gateway for all your MCP servers, with code mode, permissions and audit
Not checked yet- 3 tools
- Remote
- Open source
- AI models and LLM tooling

filex
MCP serverSelf-hosted file manager in one Go binary with a built-in MCP server for agents
Not checked yet- Remote
- Open source
- Files and documents