toggl-track-mcp-server
Provides tools to fetch Toggl Track time entries for a given date, with timezone support and authentication verification.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@toggl-track-mcp-server show my time entries for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
toggl-track-mcp-server
TypeScript MCP server (stdio) exposing tools to fetch Toggl Track v9 time entries.
Features
Single‑day time entry fetch using Toggl v9 (
/api/v9/me/time_entries).Timezone aware via Temporal polyfill (@js-temporal/polyfill):
Accepts any IANA timezone (e.g.
Asia/Tokyo,America/New_York).If
timezoneis omitted, uses your Toggl account timezone (fetched via/api/v9/me), with fallback toUTC.
Directory Layout
src/index.ts– MCP server bootstrap (registers tools)src/tools/– Tool implementationsping.tsget_time_entries_for_date.tscheck_auth.ts
src/toggl/– Toggl API clientget.ts(fetchTimeEntriesForDateV9, fetchMe)
src/utils/– Utilitiesconfig.ts(env loader)date.ts(Temporal‑based dayRange)
src/schemas/– Zod and shared typesdate.ts,toggl.ts,tools.ts
Environment
Copy
.env.templateto.envand set values:
cp .env.template .envRequired
TOGGL_API_TOKEN
Notes
.envis auto‑loaded viadotenv/config.You can also pass the token via MCP client env.
Build
npm i
npm run buildRun (stdio)
node dist/index.js --transport stdioUse with Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"toggl-track": {
"command": "/opt/homebrew/bin/node",
"args": [
"--enable-source-maps",
"/Users/yourname/path/to/toggl-track-mcp-server/dist/index.js",
"--transport",
"stdio"
],
"env": {
"TOGGL_API_TOKEN": "YOUR_TOKEN",
"TZ": "Asia/Tokyo"
}
}
}
}Use with MCP Inspector
npx @modelcontextprotocol/inspectorAdd Server → Stdio
Command:
node(or absolute node path)Args:
/path/to/dist/index.js --transport stdioEnv:
TOGGL_API_TOKEN=...,TZ=Asia/Tokyo
Tools
pingReturns
ok.
check_authVerifies token via
/api/v9/meand returns a masked summary.Params: none (uses
TOGGL_API_TOKENfrom env).
get_time_entries_for_dateFetches v9 time entries for a single date.
Params (JSON):
date(string, optional; acceptsYYYY-MM-DD,YYYY/MM/DD,今日,昨日,一昨日; omitted means today)timezone(string, IANA; optional → uses account timezone; fallbackUTC)apiToken(string; optional override for env)
Returns (JSON):
{ meta: { source: 'v9', date, timezone, startUTC, endUTC, count }, entries: [...] }
Notes
This project uses Node ESM with
module: nodenext. Write relative imports with.jsextensions in source.Timezone math uses Temporal via
@js-temporal/polyfill.
Available Tools
3 toolscheck_authARead-onlyIdempotent
Verify Toggl API token by calling /api/v9/me.
Inputs: apiToken.
get_time_entries_for_dateARead-onlyIdempotent
Fetch Toggl Track v9 time entries for a single date. Timezone accepts any IANA value and defaults to your account timezone (fallback UTC).
Inputs: date, apiToken, timezone.
pingARead-onlyIdempotent
Health check tool. Returns "ok".
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools are clearly distinct: ping for health, check_auth for token verification, and get_time_entries_for_date for fetching time entries. There is no overlap or ambiguity between them.
Tool names mostly follow a clear snake_case pattern with verb-like prefixes. 'ping' deviates slightly from the get_/check_ convention, but all names are lowercase with underscores, making them predictable and readable.
With three tools, the server is compact and each tool serves a distinct purpose: health check, auth validation, and data retrieval. While minimal, the count is reasonable for a narrow integration, though it might feel slightly thin for broader Toggl Track functionality.
The server focuses solely on fetching time entries for a single date, lacking essential operations like creating, updating, or deleting time entries, or retrieving projects/workspaces. This makes the surface significantly incomplete for a full Toggl Track workflow.
Maintenance
Related MCP Connectors
Read time entries, projects, clients, tasks and invoices; log and update tracked time.
Current time, timezone conversion & date math for AI agents. On Cloudflare Workers.
Convert and compare dates and times across any timezone with flexible, locale-aware formatting. Ad…
Timezone MCP — wraps timeapi.io (free, no auth)
Related MCP Servers
- AlicenseDqualityDmaintenanceProvides access to the Timezone By Location API to retrieve timezone information based on geographic location data.1MIT
- AlicenseAqualityDmaintenanceEnables timezone conversion, astronomical calculations, and date utilities through natural language, supporting sunrise/sunset, moon phases, business days, and more.913 npm1ISC
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Toggl Track time entries, projects, and workspaces through natural language, supporting CRUD operations and past date time slots.1318 npm2MIT

mcp-timezoneofficial
AlicenseNot gradedqualityCmaintenanceProvides timezone information via timeapi.io, enabling listing of 590+ IANA timezone strings.286 npmMIT