Toggl

Provides Toggl timer control and time-entry retrieval via MCP for conversational assistants.

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a lightweight MCP server for Toggl time tracking and control Toggl timers from Claude, ChatGPT, or any MCP-enabled language model. This server exposes a concise set of actions to manage timers, view entries, and inspect projects from Toggl Track using simple, natural-language commands.

How to use

Once you have the Toggl MCP server configured in your MCP client, you can control Toggl directly from your chat interface. Practical usage patterns include starting and stopping timers, checking the current timer, viewing today’s time entries, listing projects, and deleting specific time entries. You can also request a weekly or daily breakdown of your tracking to understand where your time goes.

How to install

Prerequisites you need before installing: Node.js and npm, or a compatible MCP client that can run stdio MCPs via npx.

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

Available 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 Toggl 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.