@souravpn/toggl-mcp 1.0.0

package/README.md

@@ -0,0 +1,171 @@
+# toggl-mcp
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives Claude access to your [Toggl Track](https://toggl.com/track/) time tracking data.
+
+Ask Claude things like:
+- *"What am I tracking right now?"*
+- *"How much time did I spend on each project this week?"*
+- *"Start a timer for writing documentation on the Blog project"*
+- *"Stop my timer"*
+- *"What did I work on yesterday?"*
+
+---
+
+## Tools
+
+| Tool | What it does |
+|------|-------------|
+| `get_current_timer` | Shows the currently running time entry |
+| `get_recent_entries` | Time entries for the past N days (default 7) |
+| `get_projects` | Lists all your projects |
+| `get_summary` | Total time by project for a date range |
+| `start_timer` | Starts a new time entry |
+| `stop_timer` | Stops the current timer |
+| `get_profile` | Your Toggl profile and workspaces |
+
+---
+
+## Setup
+
+### 1. Get your API token
+
+1. Go to **https://track.toggl.com/profile**
+2. Scroll to the bottom
+3. Click **"Click to reveal"** under API Token
+4. Copy the token
+
+### 2. Install
+
+```bash
+npm install -g toggl-mcp
+```
+
+Find the installed path:
+```bash
+which toggl-mcp
+```
+
+### 3. Add to Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "toggl": {
+      "command": "/path/from/which/toggl-mcp",
+      "env": {
+        "TOGGL_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+Or if running from source:
+
+```json
+{
+  "mcpServers": {
+    "toggl": {
+      "command": "node",
+      "args": ["/path/to/toggl-mcp/dist/index.js"],
+      "env": {
+        "TOGGL_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You should see a green "running" badge in **Settings → Developer**.
+
+### 4. Test it
+
+```
+What am I currently tracking in Toggl?
+```
+
+---
+
+## Example queries
+
+**Daily check-in:**
+```
+What have I tracked today in Toggl?
+```
+
+**Weekly review:**
+```
+Give me a summary of how I spent my time this week by project
+```
+
+**Start tracking:**
+```
+Start a Toggl timer for "reviewing PRs" on my Engineering project
+```
+
+**Stop and summarize:**
+```
+Stop my timer and tell me how long I worked
+```
+
+**Productivity analysis:**
+```
+How much time did I track last week vs the week before?
+Which project took the most time?
+```
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/yourusername/toggl-mcp
+cd toggl-mcp
+npm install
+npm run build
+
+# Test locally
+TOGGL_API_TOKEN=your_token node dist/index.js
+```
+
+### Project structure
+
+```
+toggl-mcp/
+├── src/
+│   ├── index.ts   # MCP server + tool definitions
+│   └── toggl.ts   # Toggl API v9 client + formatters
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+---
+
+## Rate limits
+
+Toggl's free plan allows 30 requests/hour per workspace. This MCP server batches calls where possible (e.g. fetching projects and entries in parallel) to stay well within limits for normal use.
+
+---
+
+## Contributing
+
+PRs welcome. Ideas for extension:
+- Tags management
+- Client listing
+- Detailed reports (daily breakdown)
+- Time entry editing
+
+---
+
+## License
+
+MIT
+
+---
+
+## Acknowledgements
+
+Built with the [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk) and the [Toggl Track API v9](https://engineering.toggl.com/docs/track/).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+// =============================================================================
+// index.ts — toggl-mcp server
+//
+// Exposes Toggl Track data as MCP tools Claude can call.
+//
+// TOOLS:
+//   get_current_timer      — what you're tracking right now
+//   get_recent_entries     — time entries for the past N days
+//   get_projects           — list all your projects
+//   get_summary            — total time by project for a date range
+//   start_timer            — start tracking time on a description/project
+//   stop_timer             — stop the currently running timer
+//   get_profile            — your Toggl profile and workspace info
+//
+// AUTH:
+//   Set TOGGL_API_TOKEN env variable.
+//   Get it from https://track.toggl.com/profile → scroll to bottom → API Token
+//
+// USAGE IN claude_desktop_config.json:
+//   {
+//     "mcpServers": {
+//       "toggl": {
+//         "command": "node",
+//         "args": ["/path/to/toggl-mcp/dist/index.js"],
+//         "env": { "TOGGL_API_TOKEN": "your_token" }
+//       }
+//     }
+//   }
+// =============================================================================
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { TogglClient, formatDuration, formatTimeEntry, isRunning, getActualDuration, } from './toggl.js';
+// ---- Validate env -----------------------------------------------------------
+const apiToken = process.env.TOGGL_API_TOKEN;
+if (!apiToken) {
+    process.stderr.write('[toggl-mcp] Error: TOGGL_API_TOKEN is not set.\n' +
+        '[toggl-mcp] Get your token from https://track.toggl.com/profile\n');
+    process.exit(1);
+}
+const client = new TogglClient(apiToken);
+// ---- MCP Server -------------------------------------------------------------
+const server = new McpServer({
+    name: 'toggl',
+    version: '1.0.0',
+});
+// Helper — wraps tool handlers with consistent error handling
+function safe(fn) {
+    return fn()
+        .then(text => ({ content: [{ type: 'text', text }] }))
+        .catch(err => ({
+        content: [{
+                type: 'text',
+                text: `Error: ${err instanceof Error ? err.message : String(err)}`,
+            }],
+    }));
+}
+// ---- Tools ------------------------------------------------------------------
+// 1. Current running timer
+server.tool('get_current_timer', 'Get the currently running Toggl time entry, if any', {}, () => safe(async () => {
+    const entry = await client.getCurrentTimeEntry();
+    if (!entry)
+        return 'No timer is currently running.';
+    const wsId = await client.getDefaultWorkspaceId();
+    const projects = await client.getProjectMap(wsId);
+    return formatTimeEntry(entry, projects);
+}));
+// 2. Recent time entries
+server.tool('get_recent_entries', 'Get time entries from the past N days (default 7). Useful for reviewing what you worked on.', {
+    days: z.number().min(1).max(90).default(7)
+        .describe('Number of days to look back (max 90)'),
+}, ({ days }) => safe(async () => {
+    const [entries, wsId] = await Promise.all([
+        client.getRecentTimeEntries(days),
+        client.getDefaultWorkspaceId(),
+    ]);
+    const projects = await client.getProjectMap(wsId);
+    if (entries.length === 0)
+        return `No time entries found in the past ${days} days.`;
+    const lines = entries
+        .slice(0, 50) // cap at 50 to avoid context overflow
+        .map(e => formatTimeEntry(e, projects))
+        .join('\n\n---\n\n');
+    const totalSeconds = entries
+        .filter(e => !isRunning(e))
+        .reduce((sum, e) => sum + getActualDuration(e), 0);
+    return `${entries.length} entries in the past ${days} days\nTotal tracked: ${formatDuration(totalSeconds)}\n\n${'='.repeat(40)}\n\n${lines}`;
+}));
+// 3. List projects
+server.tool('get_projects', 'List all Toggl projects in your workspace', {}, () => safe(async () => {
+    const wsId = await client.getDefaultWorkspaceId();
+    const projects = await client.getProjects(wsId);
+    if (projects.length === 0)
+        return 'No projects found. Create one at https://track.toggl.com';
+    const active = projects.filter(p => p.active);
+    const archived = projects.filter(p => !p.active);
+    const lines = [
+        `${active.length} active projects:`,
+        ...active.map(p => `  • ${p.name} (id: ${p.id})${p.billable ? ' 💰' : ''}`),
+    ];
+    if (archived.length > 0) {
+        lines.push(`\n${archived.length} archived projects (not shown)`);
+    }
+    return lines.join('\n');
+}));
+// 4. Summary by project
+server.tool('get_summary', 'Get total time tracked per project for a date range. Defaults to the current week.', {
+    start_date: z.string().optional()
+        .describe('Start date in YYYY-MM-DD format (default: start of current week)'),
+    end_date: z.string().optional()
+        .describe('End date in YYYY-MM-DD format (default: today)'),
+}, ({ start_date, end_date }) => safe(async () => {
+    const wsId = await client.getDefaultWorkspaceId();
+    // Default to current week
+    const now = new Date();
+    const startOfWeek = new Date(now);
+    startOfWeek.setDate(now.getDate() - now.getDay());
+    startOfWeek.setHours(0, 0, 0, 0);
+    const start = start_date ?? startOfWeek.toISOString().split('T')[0];
+    const end = end_date ?? now.toISOString().split('T')[0];
+    const summary = await client.getSummary(wsId, start, end);
+    if (summary.byProject.length === 0) {
+        return `No time tracked between ${start} and ${end}.`;
+    }
+    // Sort by most time first
+    const sorted = summary.byProject.sort((a, b) => b.seconds - a.seconds);
+    const lines = [
+        `Time summary: ${start} → ${end}`,
+        `Total: ${formatDuration(summary.totalSeconds)}`,
+        '',
+        ...sorted.map(p => {
+            const pct = ((p.seconds / summary.totalSeconds) * 100).toFixed(0);
+            return `  ${p.name}: ${formatDuration(p.seconds)} (${pct}%)`;
+        }),
+    ];
+    return lines.join('\n');
+}));
+// 5. Start a timer
+server.tool('start_timer', 'Start a new Toggl time entry. Provide a description and optionally a project name.', {
+    description: z.string().describe('What you are working on'),
+    project_name: z.string().optional()
+        .describe('Project name to log time against (must match an existing project name exactly)'),
+    tags: z.array(z.string()).optional()
+        .describe('Optional tags to apply to this time entry'),
+}, ({ description, project_name, tags }) => safe(async () => {
+    const wsId = await client.getDefaultWorkspaceId();
+    let projectId;
+    if (project_name) {
+        const projects = await client.getProjects(wsId);
+        const match = projects.find(p => p.name.toLowerCase() === project_name.toLowerCase() && p.active);
+        if (!match) {
+            const names = projects.filter(p => p.active).map(p => p.name).join(', ');
+            return `Project "${project_name}" not found. Available projects: ${names}`;
+        }
+        projectId = match.id;
+    }
+    const entry = await client.startTimer(wsId, description, projectId, tags);
+    const projects = await client.getProjectMap(wsId);
+    return `✅ Timer started!\n\n${formatTimeEntry(entry, projects)}`;
+}));
+// 6. Stop current timer
+server.tool('stop_timer', 'Stop the currently running Toggl time entry', {}, () => safe(async () => {
+    const current = await client.getCurrentTimeEntry();
+    if (!current)
+        return 'No timer is currently running.';
+    const wsId = await client.getDefaultWorkspaceId();
+    const stopped = await client.stopTimer(wsId, current.id);
+    const projects = await client.getProjectMap(wsId);
+    return `⏹ Timer stopped!\n\n${formatTimeEntry(stopped, projects)}`;
+}));
+// 7. Profile
+server.tool('get_profile', "Get the user's Toggl profile — name, email, timezone, and workspace info", {}, () => safe(async () => {
+    const [me, workspaces] = await Promise.all([
+        client.getMe(),
+        client.getWorkspaces(),
+    ]);
+    return [
+        `Name: ${me.fullname}`,
+        `Email: ${me.email}`,
+        `Timezone: ${me.timezone}`,
+        `Default workspace ID: ${me.default_workspace_id}`,
+        '',
+        `Workspaces (${workspaces.length}):`,
+        ...workspaces.map(w => `  • ${w.name} (id: ${w.id})${w.premium ? ' [Premium]' : ' [Free]'}`),
+    ].join('\n');
+}));
+// ---- Start ------------------------------------------------------------------
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write('[toggl-mcp] Server running\n');
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/toggl.d.ts

@@ -0,0 +1,77 @@
+export interface TogglUser {
+    id: number;
+    email: string;
+    fullname: string;
+    timezone: string;
+    default_workspace_id: number;
+    beginning_of_week: number;
+}
+export interface TogglWorkspace {
+    id: number;
+    name: string;
+    premium: boolean;
+    plan: string;
+}
+export interface TogglProject {
+    id: number;
+    name: string;
+    workspace_id: number;
+    color: string;
+    active: boolean;
+    billable: boolean | null;
+    client_id: number | null;
+}
+export interface TogglTag {
+    id: number;
+    name: string;
+    workspace_id: number;
+}
+export interface TogglTimeEntry {
+    id: number;
+    workspace_id: number;
+    project_id: number | null;
+    task_id: number | null;
+    billable: boolean;
+    start: string;
+    stop: string | null;
+    duration: number;
+    description: string | null;
+    tag_ids: number[];
+    tags: string[];
+    at: string;
+}
+export interface TogglClient {
+    id: number;
+    name: string;
+    workspace_id: number;
+}
+export declare function formatDuration(seconds: number): string;
+export declare function formatDate(iso: string): string;
+export declare function isRunning(entry: TogglTimeEntry): boolean;
+export declare function getActualDuration(entry: TogglTimeEntry): number;
+export declare function formatTimeEntry(entry: TogglTimeEntry, projects: Map<number, string>): string;
+export declare class TogglClient {
+    private authHeader;
+    private _workspaceId;
+    constructor(apiToken: string);
+    private request;
+    getMe(): Promise<TogglUser>;
+    getWorkspaces(): Promise<TogglWorkspace[]>;
+    getDefaultWorkspaceId(): Promise<number>;
+    getProjects(workspaceId: number): Promise<TogglProject[]>;
+    getProjectMap(workspaceId: number): Promise<Map<number, string>>;
+    getTags(workspaceId: number): Promise<TogglTag[]>;
+    getCurrentTimeEntry(): Promise<TogglTimeEntry | null>;
+    getTimeEntries(startDate?: string, endDate?: string): Promise<TogglTimeEntry[]>;
+    getRecentTimeEntries(days?: number): Promise<TogglTimeEntry[]>;
+    startTimer(workspaceId: number, description: string, projectId?: number, tags?: string[]): Promise<TogglTimeEntry>;
+    stopTimer(workspaceId: number, entryId: number): Promise<TogglTimeEntry>;
+    getSummary(workspaceId: number, startDate: string, endDate: string): Promise<{
+        totalSeconds: number;
+        byProject: {
+            name: string;
+            seconds: number;
+        }[];
+    }>;
+}
+//# sourceMappingURL=toggl.d.ts.map

package/dist/toggl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggl.d.ts","sourceRoot":"","sources":["../src/toggl.ts"],"names":[],"mappings":"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"}

package/dist/toggl.js

@@ -0,0 +1,170 @@
+// =============================================================================
+// toggl.ts — Toggl Track API v9 client
+//
+// Auth: HTTP Basic — API token as username, "api_token" as password
+// Base URL: https://api.track.toggl.com/api/v9
+//
+// API docs: https://engineering.toggl.com/docs/track/
+// =============================================================================
+const BASE_URL = 'https://api.track.toggl.com/api/v9';
+const REPORTS_URL = 'https://api.track.toggl.com/reports/api/v3';
+// ---- Helpers ----------------------------------------------------------------
+export function formatDuration(seconds) {
+    if (seconds < 0)
+        return 'Running...';
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = seconds % 60;
+    if (h > 0)
+        return `${h}h ${m}m`;
+    if (m > 0)
+        return `${m}m ${s}s`;
+    return `${s}s`;
+}
+export function formatDate(iso) {
+    return new Date(iso).toLocaleString();
+}
+export function isRunning(entry) {
+    return entry.duration < 0;
+}
+export function getActualDuration(entry) {
+    if (entry.duration >= 0)
+        return entry.duration;
+    // Running entry: duration = -(start time in epoch seconds)
+    return Math.floor(Date.now() / 1000) + entry.duration;
+}
+export function formatTimeEntry(entry, projects) {
+    const running = isRunning(entry);
+    const duration = getActualDuration(entry);
+    const projectName = entry.project_id
+        ? (projects.get(entry.project_id) ?? `Project #${entry.project_id}`)
+        : 'No project';
+    return [
+        `${running ? '▶ [RUNNING] ' : ''}${entry.description ?? '(no description)'}`,
+        `Project: ${projectName}`,
+        `Duration: ${formatDuration(duration)}${running ? ' (so far)' : ''}`,
+        `Started: ${formatDate(entry.start)}`,
+        entry.stop ? `Stopped: ${formatDate(entry.stop)}` : null,
+        entry.tags.length > 0 ? `Tags: ${entry.tags.join(', ')}` : null,
+        entry.billable ? `Billable: Yes` : null,
+    ].filter(Boolean).join('\n');
+}
+// ---- API Client -------------------------------------------------------------
+export class TogglClient {
+    authHeader;
+    _workspaceId = null;
+    constructor(apiToken) {
+        // Toggl auth: base64(token:api_token)
+        this.authHeader = 'Basic ' + Buffer.from(`${apiToken}:api_token`).toString('base64');
+    }
+    async request(path, options = {}, baseUrl = BASE_URL) {
+        const url = `${baseUrl}${path}`;
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                Authorization: this.authHeader,
+                'Content-Type': 'application/json',
+                ...options.headers,
+            },
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`Toggl API error ${response.status} on ${path}: ${body}`);
+        }
+        // 204 No Content
+        if (response.status === 204)
+            return null;
+        return response.json();
+    }
+    // ---- User & Workspace ----
+    async getMe() {
+        return this.request('/me');
+    }
+    async getWorkspaces() {
+        return this.request('/workspaces');
+    }
+    // Get default workspace ID (cached)
+    async getDefaultWorkspaceId() {
+        if (this._workspaceId)
+            return this._workspaceId;
+        const me = await this.getMe();
+        this._workspaceId = me.default_workspace_id;
+        return this._workspaceId;
+    }
+    // ---- Projects ----
+    async getProjects(workspaceId) {
+        const projects = await this.request(`/workspaces/${workspaceId}/projects`);
+        return projects ?? [];
+    }
+    async getProjectMap(workspaceId) {
+        const projects = await this.getProjects(workspaceId);
+        return new Map(projects.map(p => [p.id, p.name]));
+    }
+    // ---- Tags ----
+    async getTags(workspaceId) {
+        const tags = await this.request(`/workspaces/${workspaceId}/tags`);
+        return tags ?? [];
+    }
+    // ---- Time Entries ----
+    async getCurrentTimeEntry() {
+        try {
+            return await this.request('/me/time_entries/current');
+        }
+        catch {
+            return null;
+        }
+    }
+    async getTimeEntries(startDate, endDate) {
+        const params = new URLSearchParams();
+        if (startDate)
+            params.set('start_date', startDate);
+        if (endDate)
+            params.set('end_date', endDate);
+        const query = params.toString() ? `?${params}` : '';
+        const entries = await this.request(`/me/time_entries${query}`);
+        return entries ?? [];
+    }
+    async getRecentTimeEntries(days = 7) {
+        const start = new Date();
+        start.setDate(start.getDate() - days);
+        return this.getTimeEntries(start.toISOString());
+    }
+    // ---- Start / Stop ----
+    async startTimer(workspaceId, description, projectId, tags) {
+        return this.request(`/workspaces/${workspaceId}/time_entries`, {
+            method: 'POST',
+            body: JSON.stringify({
+                created_with: 'toggl-mcp',
+                description,
+                project_id: projectId ?? null,
+                tags: tags ?? [],
+                start: new Date().toISOString(),
+                duration: -1, // -1 means running
+                workspace_id: workspaceId,
+            }),
+        });
+    }
+    async stopTimer(workspaceId, entryId) {
+        return this.request(`/workspaces/${workspaceId}/time_entries/${entryId}/stop`, { method: 'PATCH' });
+    }
+    // ---- Summary / Reports ----
+    async getSummary(workspaceId, startDate, endDate) {
+        // Use the reports API for aggregated data
+        const body = await this.request(`/workspace/${workspaceId}/summary/time_entries`, {
+            method: 'POST',
+            body: JSON.stringify({
+                start_date: startDate.split('T')[0], // reports API wants YYYY-MM-DD
+                end_date: endDate.split('T')[0],
+                grouping: 'projects',
+                sub_grouping: 'time_entries',
+            }),
+        }, REPORTS_URL);
+        const byProject = (body.groups ?? []).map(g => ({
+            name: g.title.project ?? 'No project',
+            seconds: g.sub_groups.reduce((sum, sg) => sum + sg.seconds, 0),
+        }));
+        const totalSeconds = byProject.reduce((sum, p) => sum + p.seconds, 0);
+        return { totalSeconds, byProject };
+    }
+}
+//# sourceMappingURL=toggl.js.map

package/dist/toggl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggl.js","sourceRoot":"","sources":["../src/toggl.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@souravpn/toggl-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Toggl Track — gives Claude access to your time tracking data",
+  "keywords": [
+    "mcp",
+    "toggl",
+    "time-tracking",
+    "productivity",
+    "claude",
+    "ai"
+  ],
+  "author": "Sourav Nayak",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "toggl-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "mcpName": "io.github.souravpn/toggl-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/souravpn/toggl-mcp.git"
+  }
+}