@yakirmar/mcp-toggl 1.1.0

package/docs/images/monthly-heatmap.svg

@@ -0,0 +1,124 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 380" role="img" aria-label="Calendar heatmap of April 2026 plus May 1: 26 active days, 219.6 hours total. Longest day Apr 2 at 18.2 hours. Most consistent stretch Apr 20 to 25 with 6 straight days of 9 to 14 hours.">
+<title>April recap — 219.6 hrs across 26 active days</title>
+<desc>Calendar heatmap showing daily hours tracked across April 2026 and May 1. Color intensity scales from light green (under 4 hours) to dark green (over 16 hours). Empty cells represent days with no entries. Off days: April 7, 11, 14-15, and 26.</desc>
+<style>
+.title { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 16px; font-weight: 500; fill: #2C2C2A; }
+.subtitle { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 12px; fill: #5F5E5A; }
+.day-label { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 11px; fill: #5F5E5A; }
+.month-label { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 10px; fill: #888780; }
+.legend-text { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 11px; fill: #5F5E5A; }
+.stat-label { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 12px; fill: #5F5E5A; }
+.stat-value { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 22px; font-weight: 500; fill: #2C2C2A; }
+.stat-sub { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 11px; fill: #888780; }
+.note-label { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 12px; fill: #5F5E5A; }
+.note-value { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 13px; font-weight: 500; fill: #2C2C2A; }
+@media (prefers-color-scheme: dark) {
+  .title { fill: #F1EFE8; }
+  .subtitle { fill: #B4B2A9; }
+  .day-label { fill: #B4B2A9; }
+  .month-label { fill: #888780; }
+  .legend-text { fill: #B4B2A9; }
+  .stat-label { fill: #B4B2A9; }
+  .stat-value { fill: #F1EFE8; }
+  .stat-sub { fill: #888780; }
+  .note-label { fill: #B4B2A9; }
+  .note-value { fill: #F1EFE8; }
+}
+</style>
+
+<text x="20" y="28" class="title">April recap — 219.6 hrs across 26 active days</text>
+<text x="20" y="48" class="subtitle">Apr 1 → May 1 · daily hours tracked</text>
+
+<text x="60" y="100" class="day-label" text-anchor="end">Mon</text>
+<text x="60" y="136" class="day-label" text-anchor="end">Tue</text>
+<text x="60" y="172" class="day-label" text-anchor="end">Wed</text>
+<text x="60" y="208" class="day-label" text-anchor="end">Thu</text>
+<text x="60" y="244" class="day-label" text-anchor="end">Fri</text>
+<text x="60" y="280" class="day-label" text-anchor="end">Sat</text>
+<text x="60" y="316" class="day-label" text-anchor="end">Sun</text>
+
+<rect x="70" y="80" width="32" height="32" fill="#F1EFE8" rx="4" opacity="0.4" />
+<rect x="70" y="116" width="32" height="32" fill="#F1EFE8" rx="4" opacity="0.4" />
+<rect x="70" y="152" width="32" height="32" fill="#5DCAA5" rx="4" />
+<rect x="70" y="188" width="32" height="32" fill="#085041" rx="4" />
+<rect x="70" y="224" width="32" height="32" fill="#9FE1CB" rx="4" />
+<rect x="70" y="260" width="32" height="32" fill="#9FE1CB" rx="4" />
+<rect x="70" y="296" width="32" height="32" fill="#9FE1CB" rx="4" />
+
+<rect x="106" y="80" width="32" height="32" fill="#5DCAA5" rx="4" />
+<rect x="106" y="116" width="32" height="32" fill="#E8E5DA" rx="4" />
+<rect x="106" y="152" width="32" height="32" fill="#9FE1CB" rx="4" />
+<rect x="106" y="188" width="32" height="32" fill="#085041" rx="4" />
+<rect x="106" y="224" width="32" height="32" fill="#1D9E75" rx="4" />
+<rect x="106" y="260" width="32" height="32" fill="#E8E5DA" rx="4" />
+<rect x="106" y="296" width="32" height="32" fill="#9FE1CB" rx="4" />
+
+<rect x="142" y="80" width="32" height="32" fill="#1D9E75" rx="4" />
+<rect x="142" y="116" width="32" height="32" fill="#E8E5DA" rx="4" />
+<rect x="142" y="152" width="32" height="32" fill="#E8E5DA" rx="4" />
+<rect x="142" y="188" width="32" height="32" fill="#0F6E56" rx="4" />
+<rect x="142" y="224" width="32" height="32" fill="#5DCAA5" rx="4" />
+<rect x="142" y="260" width="32" height="32" fill="#1D9E75" rx="4" />
+<rect x="142" y="296" width="32" height="32" fill="#1D9E75" rx="4" />
+
+<rect x="178" y="80" width="32" height="32" fill="#1D9E75" rx="4" />
+<rect x="178" y="116" width="32" height="32" fill="#0F6E56" rx="4" />
+<rect x="178" y="152" width="32" height="32" fill="#1D9E75" rx="4" />
+<rect x="178" y="188" width="32" height="32" fill="#0F6E56" rx="4" />
+<rect x="178" y="224" width="32" height="32" fill="#0F6E56" rx="4" />
+<rect x="178" y="260" width="32" height="32" fill="#1D9E75" rx="4" />
+<rect x="178" y="296" width="32" height="32" fill="#E8E5DA" rx="4" />
+
+<rect x="214" y="80" width="32" height="32" fill="#5DCAA5" rx="4" />
+<rect x="214" y="116" width="32" height="32" fill="#0F6E56" rx="4" />
+<rect x="214" y="152" width="32" height="32" fill="#5DCAA5" rx="4" />
+<rect x="214" y="188" width="32" height="32" fill="#5DCAA5" rx="4" />
+<rect x="214" y="224" width="32" height="32" fill="#9FE1CB" rx="4" />
+<rect x="214" y="260" width="32" height="32" fill="#F1EFE8" rx="4" opacity="0.4" />
+<rect x="214" y="296" width="32" height="32" fill="#F1EFE8" rx="4" opacity="0.4" />
+
+<text x="86" y="64" class="month-label" text-anchor="middle">Mar 30</text>
+<text x="194" y="64" class="month-label" text-anchor="middle">Apr 13</text>
+<text x="230" y="64" class="month-label" text-anchor="middle">Apr 27</text>
+
+<g transform="translate(70, 348)">
+<text x="0" y="0" class="legend-text">Less</text>
+<rect x="32" y="-9" width="11" height="11" fill="#E8E5DA" rx="2" />
+<rect x="48" y="-9" width="11" height="11" fill="#9FE1CB" rx="2" />
+<rect x="64" y="-9" width="11" height="11" fill="#5DCAA5" rx="2" />
+<rect x="80" y="-9" width="11" height="11" fill="#1D9E75" rx="2" />
+<rect x="96" y="-9" width="11" height="11" fill="#0F6E56" rx="2" />
+<rect x="112" y="-9" width="11" height="11" fill="#085041" rx="2" />
+<text x="130" y="0" class="legend-text">More</text>
+<text x="170" y="0" class="legend-text" fill="#888780">0h · &lt;4h · 4-8h · 8-12h · 12-16h · 16h+</text>
+</g>
+
+<g transform="translate(310, 80)">
+<text x="0" y="14" class="stat-label">Total tracked</text>
+<text x="0" y="42" class="stat-value">219.6</text>
+<text x="74" y="42" class="stat-sub">hrs</text>
+
+<text x="0" y="84" class="stat-label">Active days</text>
+<text x="0" y="112" class="stat-value">26</text>
+<text x="46" y="112" class="stat-sub">of 31 (84%)</text>
+
+<text x="0" y="154" class="stat-label">Avg active day</text>
+<text x="0" y="182" class="stat-value">8.4</text>
+<text x="58" y="182" class="stat-sub">hrs</text>
+</g>
+
+<g transform="translate(530, 80)">
+<text x="0" y="14" class="note-label">Longest day</text>
+<text x="0" y="34" class="note-value">Apr 2 — 18.2 hrs</text>
+<text x="0" y="52" class="stat-sub">"AI shit" + late call w/ Spence</text>
+
+<text x="0" y="92" class="note-label">Best stretch</text>
+<text x="0" y="112" class="note-value">Apr 20 → 25 · 6 days</text>
+<text x="0" y="130" class="stat-sub">avg 11.9 hrs/day, no breaks</text>
+
+<text x="0" y="170" class="note-label">Days off</text>
+<text x="0" y="190" class="note-value">5 · Apr 7, 11, 14, 15, 26</text>
+<text x="0" y="208" class="stat-sub">2 weekend pairs, mostly steady</text>
+</g>
+</svg>

package/docs/images/weekly-recap.svg

@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 440" role="img" aria-label="Stacked bar chart of weekly hours by project, Apr 27 to May 1: Mon 2.5, Tue 15.8, Wed 6.9, Thu 2.2, Fri 5.2; total 32.7 hours across 7 projects">
+<title>Week of Apr 27 — 32.7 hours across 7 projects</title>
+<desc>Daily hours stacked by project. Tuesday peaks at 15.8 hours covering Business Development, AutoMem, Automation Hub, and MCP Servers. Wednesday is 6.9 hours of AI Learning. Friday is 5.2 hours, mostly Toggl MCP shipping work.</desc>
+<style>
+.title { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 16px; font-weight: 500; fill: #2C2C2A; }
+.subtitle { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 12px; fill: #5F5E5A; }
+.axis { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 11px; fill: #5F5E5A; }
+.day-total { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 11px; font-weight: 500; fill: #2C2C2A; }
+.legend-text { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif; font-size: 11px; fill: #2C2C2A; }
+.grid { stroke: rgba(0,0,0,0.08); stroke-width: 1; }
+@media (prefers-color-scheme: dark) {
+  .title { fill: #F1EFE8; }
+  .subtitle { fill: #B4B2A9; }
+  .axis { fill: #B4B2A9; }
+  .day-total { fill: #F1EFE8; }
+  .legend-text { fill: #F1EFE8; }
+  .grid { stroke: rgba(255,255,255,0.10); }
+}
+</style>
+
+<text x="20" y="28" class="title">Week of Apr 27 — 32.7 hrs across 7 projects</text>
+<text x="20" y="48" class="subtitle">Daily hours stacked by project · 31 entries</text>
+
+<line x1="60" y1="80" x2="770" y2="80" class="grid" />
+<text x="50" y="84" class="axis" text-anchor="end">16h</text>
+<line x1="60" y1="145" x2="770" y2="145" class="grid" />
+<text x="50" y="149" class="axis" text-anchor="end">12h</text>
+<line x1="60" y1="210" x2="770" y2="210" class="grid" />
+<text x="50" y="214" class="axis" text-anchor="end">8h</text>
+<line x1="60" y1="275" x2="770" y2="275" class="grid" />
+<text x="50" y="279" class="axis" text-anchor="end">4h</text>
+<line x1="60" y1="340" x2="770" y2="340" class="grid" />
+<text x="50" y="344" class="axis" text-anchor="end">0h</text>
+
+<g>
+<rect x="96" y="306.7" width="70" height="33.3" fill="#378ADD" />
+<rect x="96" y="300.0" width="70" height="6.7" fill="#1D9E75" />
+<text x="131" y="293" class="day-total" text-anchor="middle">2.5h</text>
+<text x="131" y="360" class="axis" text-anchor="middle">Mon</text>
+<text x="131" y="375" class="axis" text-anchor="middle">Apr 27</text>
+</g>
+
+<g>
+<rect x="238" y="246.1" width="70" height="93.9" fill="#378ADD" />
+<rect x="238" y="159.8" width="70" height="86.3" fill="#7F77DD" />
+<rect x="238" y="113.2" width="70" height="46.6" fill="#1D9E75" />
+<rect x="238" y="82.6" width="70" height="30.6" fill="#EF9F27" />
+<text x="273" y="76" class="day-total" text-anchor="middle">15.8h</text>
+<text x="273" y="360" class="axis" text-anchor="middle">Tue</text>
+<text x="273" y="375" class="axis" text-anchor="middle">Apr 28</text>
+</g>
+
+<g>
+<rect x="380" y="227.4" width="70" height="112.6" fill="#D85A30" />
+<text x="415" y="220" class="day-total" text-anchor="middle">6.9h</text>
+<text x="415" y="360" class="axis" text-anchor="middle">Wed</text>
+<text x="415" y="375" class="axis" text-anchor="middle">Apr 29</text>
+</g>
+
+<g>
+<rect x="522" y="326.2" width="70" height="13.8" fill="#378ADD" />
+<rect x="522" y="307.5" width="70" height="18.7" fill="#D85A30" />
+<rect x="522" y="303.9" width="70" height="3.6" fill="#1D9E75" />
+<text x="557" y="297" class="day-total" text-anchor="middle">2.2h</text>
+<text x="557" y="360" class="axis" text-anchor="middle">Thu</text>
+<text x="557" y="375" class="axis" text-anchor="middle">Apr 30</text>
+</g>
+
+<g>
+<rect x="664" y="338.05" width="70" height="1.95" fill="#378ADD" />
+<rect x="664" y="312.85" width="70" height="25.2" fill="#1D9E75" />
+<rect x="664" y="267.85" width="70" height="45.0" fill="#D4537E" />
+<rect x="664" y="260.55" width="70" height="7.3" fill="#EF9F27" />
+<rect x="664" y="255.35" width="70" height="5.2" fill="#888780" />
+<text x="699" y="248" class="day-total" text-anchor="middle">5.2h</text>
+<text x="699" y="360" class="axis" text-anchor="middle">Fri</text>
+<text x="699" y="375" class="axis" text-anchor="middle">May 1</text>
+</g>
+
+<g transform="translate(20, 405)">
+<rect x="0" y="0" width="10" height="10" fill="#378ADD" />
+<text x="16" y="9" class="legend-text">Business Dev</text>
+<rect x="108" y="0" width="10" height="10" fill="#D85A30" />
+<text x="124" y="9" class="legend-text">AI Learning</text>
+<rect x="208" y="0" width="10" height="10" fill="#7F77DD" />
+<text x="224" y="9" class="legend-text">AutoMem</text>
+<rect x="296" y="0" width="10" height="10" fill="#1D9E75" />
+<text x="312" y="9" class="legend-text">Automation Hub</text>
+<rect x="416" y="0" width="10" height="10" fill="#D4537E" />
+<text x="432" y="9" class="legend-text">Toggl MCP</text>
+<rect x="516" y="0" width="10" height="10" fill="#EF9F27" />
+<text x="532" y="9" class="legend-text">MCP Servers</text>
+<rect x="624" y="0" width="10" height="10" fill="#888780" />
+<text x="640" y="9" class="legend-text">WPF Support</text>
+</g>
+</svg>

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@yakirmar/mcp-toggl",
+  "version": "1.1.0",
+  "description": "MCP server for Toggl Track integration with time tracking and reporting",
+  "main": "dist/index.js",
+  "type": "module",
+  "mcpName": "io.github.yakirmar/mcp-toggl",
+  "bin": {
+    "mcp-toggl": "dist/index.js"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "postbuild": "chmod +x dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "setup": "node scripts/setup.js",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ tests/",
+    "format": "prettier --write src/**/*.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "modelcontextprotocol",
+    "toggl",
+    "time-tracking",
+    "reporting",
+    "productivity"
+  ],
+  "author": "Very Good Plugins",
+  "contributors": [
+    "Yakir Marziano"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yakirmar/mcp-toggl.git"
+  },
+  "homepage": "https://github.com/yakirmar/mcp-toggl#readme",
+  "bugs": {
+    "url": "https://github.com/yakirmar/mcp-toggl/issues"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/",
+    "docs/images/*.svg",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "dotenv": "^17.4.2",
+    "node-fetch": "^3.3.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "eslint": "^10.2.1",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.1.0",
+    "tsx": "^4.6.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.1",
+    "vitest": "^4.1.5"
+  }
+}