How do I install the louis030195/toggl-mcp MCP server?

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "toggl-mcp": { "command": "npx", "args": ["-y", "louis030195/toggl-mcp"] } }

louis030195/toggl-mcp

0 Views

0 Installs

📇 ☁️ 🍎 🪟 🐧 - 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.

Quick Install

One-Click IDE Configuration

claude_desktop_config.json

{
  "mcpServers": {
    "louis030195-toggl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "louis030195-toggl-mcp"
      ]
    }
  }
}

Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.

Documentation Overview

@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):

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

Claude Code

# 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

# 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