@louis030195/toggl-mcp

Dead simple MCP (Model Context Protocol) server for Toggl time tracking. Control your Toggl timer directly from Claude, ChatGPT, or any LLM that supports MCP.

Features

⏱️ Start/stop timers
📊 View current timer
📈 Get today's time entries
🗂️ List projects
🗑️ Delete time entries

Installation

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

hljs language-json

{
  "mcpServers": {
    "toggl": {
      "command": "npx",
      "args": ["-y", "@louis030195/toggl-mcp"],
      "env": {
        "TOGGL_API_KEY": "your-toggl-api-key"
      }
    }
  }
}

Claude Code

hljs language-bash

# Install globally in user scope with API key
claude mcp add -s user toggl npx -e TOGGL_API_KEY=your-toggl-api-key -- -y @louis030195/toggl-mcp

Get Your Toggl API Key

Go to Toggl Track Profile
Scroll down to "API Token"
Click "Click to reveal" and copy your token

Usage

Once configured, you can use natural language to control Toggl:

"Start tracking work on the MCP server project"
"Stop the current timer"
"What am I currently tracking?"
"Show me today's time entries"
"List all my projects"

Tools

`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.

Parameters: week_offset (optional, number)
- 0 = current week
- -1 = last week
- -2 = two weeks ago, etc.

Returns:

Total hours for the week
Daily breakdown (hours per day)
Project breakdown (hours per project)
Full list of entries

`toggl_last_week`

Convenience function to get last week's time tracking summary (equivalent to toggl_weekly with week_offset: -1).

Development

hljs language-bash

# Clone the repo
git clone https://github.com/louis030195/toggl-mcp.git
cd toggl-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
TOGGL_API_KEY=your-api-key npm start

License

MIT

Author

Louis Beaumont

toggl-mcp