# louis030195/toggl-mcp [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/louis030195/toggl-mcp  
**GitHub Stars:** 3  
**npm Downloads (last month):** 86  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/louis030195-toggl-mcp

## Description
Time tracking integration with Toggl Track. Start/stop timers, manage time entries, track project time, and get today's summary. Perfect for productivity tracking and billing workflows.

## Tools
Capabilities this server exposes over MCP:

- **toggl_start** — Start a new timer with a description and optional project.
- **toggl_stop** — Stop the currently running timer.
- **toggl_current** — Get information about the currently running timer.
- **toggl_today** — Get all time entries for today with total duration.
- **toggl_projects** — List all projects in your workspace.
- **toggl_delete** — Delete a time entry by its ID.
- **toggl_weekly** — Get weekly time tracking summary with total hours and breakdowns.
- **toggl_last_week** — Convenience function to get last week's time tracking summary (equivalent to `toggl_weekly` with `week_offset: -1`).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "toggl-mcp": {
    "command": "npx",
    "args": ["-y","-e"],
    "env": {
      "TOGGL_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `TOGGL_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What louis030195/toggl-mcp MCP server does

The louis030195/toggl-mcp MCP server exposes Toggl Track time-tracking actions as MCP tools. It supports both active-timer operations and reporting workflows, so an MCP client can record work, inspect the current session, and review accumulated hours.

The available operations include starting a timer with a description and optional project, stopping the running timer, and retrieving details about the current timer. Agents can also list projects in the connected workspace and remove a time entry by ID. Reporting tools return today's entries and total duration, or a weekly view with total hours, daily totals, project totals, and the underlying entries.

## How it works

The server runs locally as a Node-based MCP process and uses the Toggl API token supplied through its environment. An MCP client sends tool calls over the local server connection; the server then performs the corresponding Toggl Track operation.

Weekly reporting accepts an optional `week_offset` value. Zero represents the current week, `-1` selects the previous week, and more negative values select earlier weeks. The `toggl_last_week` tool provides the previous-week case directly and is equivalent to calling the weekly tool with `week_offset: -1`.

## Setup and configuration

The louis030195/toggl-mcp MCP server requires the `TOGGL_API_KEY` environment variable. The README directs users to the API Token section of their Toggl Track profile to obtain the value.

For Claude Desktop, add a server entry that runs `npx -y @louis030195/toggl-mcp` and passes `TOGGL_API_KEY` in the entry's environment. The README also gives a Claude Code command using the same package and environment variable. For local development, clone the repository, run `npm install`, build with `npm run build`, and start it with `TOGGL_API_KEY` set.

## Tools and capabilities

- `toggl_start`: starts a timer with a description and optional project.
- `toggl_stop`: stops the currently running timer.
- `toggl_current`: returns information about the active timer.
- `toggl_today`: lists today's entries and their total duration.
- `toggl_projects`: lists projects in the workspace.
- `toggl_delete`: deletes a time entry using its ID.
- `toggl_weekly`: reports weekly totals, daily and project breakdowns, and all entries for the selected week.
- `toggl_last_week`: returns the previous week's report.

## Limitations and notes

The louis030195/toggl-mcp MCP server is focused on the operations documented in the repository. The material does not describe editing existing entries, creating projects, changing workspace settings, or supporting multiple Toggl accounts. Deletion requires the relevant time-entry ID, while starting a timer accepts a project optionally rather than requiring one.

The documented client configuration specifically covers Claude Desktop and Claude Code. The README also states that the server can be used with ChatGPT or other LLM clients that support MCP, but it does not provide configuration instructions for those clients.

_Full upstream README: https://allmcps.com/mcp/louis030195-toggl-mcp/readme_