Elysia Tools Docs
EN
Language
ZHESPTRUFRDEEN
Back to site
Browse tools

Data Visualization

Calendar Heatmap Generator

Generate GitHub-style calendar heatmaps to visualize activity patterns over time, perfect for tracking yearly contributions, habits, or metrics

html· HTML resultOpen tool

Quick start

Call this tool from your code in three languages.

cURL
curl -X POST 'https://api.elysiatools.com/en/api/tools/calendar-heatmap' \
  -H 'Content-Type: application/json' \
  -d '{"chartData":"JSON format:\n[{"date": "2024-01-01", "value": 10, "label": "Commits"},\n{"date": "2024-01-02", "value": 15, "label": "Commits"}]\n\nor text format:\n2024-01-01|10|Commits\n2024-01-02|15|Commits","chartTitle":"Enter chart title...","colorScheme":"green","year":0,"startColor":"#c6e48b","endColor":"#239a3b","emptyColor":"#ebedf0","borderColor":"#ffffff","cellSize":"12","cellSpacing":"2","animationDuration":"800","backgroundColor":"#ffffff","showValues":false,"showLegend":true,"showMonthLabels":true,"showDayLabels":true,"showStats":true,"showTooltip":true}'

© 2026 Elysia Tools. Developer documentation.

Back to siteBrowse tools

API reference

Send a POST request with your inputs as JSON. File parameters require a separate upload first.

Endpoint

HTTP
POST https://api.elysiatools.com/en/api/tools/calendar-heatmap

Parameters

NameTypeRequiredDescription
chartDatatextareaYesActivity data for the calendar heatmap. Format: date|value|label (YYYY-MM-DD format)
chartTitletextNoTitle that will be displayed above the heatmap
colorSchemeselectNo—
yearnumberNoYear for the calendar (leave empty for current year)
startColorcolorNoStart color for custom color scheme (requires Custom Colors selection)
endColorcolorNoEnd color for custom color scheme (requires Custom Colors selection)
emptyColorcolorNoColor for days with no activity
borderColorcolorNoBorder color for cells
cellSizenumberNoSize of each day cell in pixels (8-20)
cellSpacingnumberNoSpacing between cells in pixels (1-5)
animationDurationnumberNoAnimation duration in milliseconds
backgroundColorcolorNoBackground color for the chart container
showValuescheckboxNoDisplay values inside the cells (works better with larger cells)
showLegendcheckboxNoDisplay the color intensity legend
showMonthLabelscheckboxNoDisplay month names above the calendar
showDayLabelscheckboxNoDisplay day of week labels
showStatscheckboxNoDisplay activity statistics below the chart
showTooltipcheckboxNoEnable hover tooltips for cells

Response format

HTML result

JSON
{
  "result": "<div>Processed HTML content</div>",
  "error": "Error message (optional)",
  "message": "Notification message (optional)",
  "metadata": {
    "key": "value"
  }
}

MCP integration

Add this tool to your Model Context Protocol server so AI agents can list and call it.

Server configuration

Add this block to your MCP client configuration:

mcp.json
{
  "mcpServers": {
    "elysiatools-calendar-heatmap": {
      "name": "calendar-heatmap",
      "description": "Generate GitHub-style calendar heatmaps to visualize activity patterns over time, perfect for tracking yearly contributions, habits, or metrics",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=calendar-heatmap",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

List available tools

After connecting to the SSE endpoint, list the exposed tools:

tools/list
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Call this tool

Invoke the tool by its id, passing arguments built from its parameters:

tools/call
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "calendar-heatmap",
    "arguments": {
  "chartData": "JSON format:\n[{&quot;date&quot;: &quot;2024-01-01&quot;, &quot;value&quot;: 10, &quot;label&quot;: &quot;Commits&quot;},\n{&quot;date&quot;: &quot;2024-01-02&quot;, &quot;value&quot;: 15, &quot;label&quot;: &quot;Commits&quot;}]\n\nor text format:\n2024-01-01|10|Commits\n2024-01-02|15|Commits",
  "chartTitle": "Enter chart title...",
  "colorScheme": "green",
  "year": 0,
  "startColor": "#c6e48b",
  "endColor": "#239a3b",
  "emptyColor": "#ebedf0",
  "borderColor": "#ffffff",
  "cellSize": "12",
  "cellSpacing": "2",
  "animationDuration": "800",
  "backgroundColor": "#ffffff",
  "showValues": false,
  "showLegend": true,
  "showMonthLabels": true,
  "showDayLabels": true,
  "showStats": true,
  "showTooltip": true
}
  }
}
Chain multiple tools in one session with a comma-separated toolId list, e.g. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max 20).

Questions or issues? Contact [email protected]

Browse tools
Open tool