toggl-track-mcp

An MCP server for Toggl Track.

Installation

gem install toggl_track_mcp

Or add to your Gemfile:

gem "toggl_track_mcp"

Setup

Set your Toggl Track API token as the environment variable TOGGL_API_TOKEN. You can find it at Toggl Track Profile.

TOGGL_TZ is the timezone offset (default: +09:00).

Usage

Example configuration for Claude Desktop:

{
  "mcpServers": {
    "toggl-track": {
      "command": "toggl-track-mcp",
      "env": {
        "TOGGL_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Tools

Tool	Description
get_current_entry	Get the currently running time entry
get_today_entries	List today's time entries
get_entries_by_date	Get time entries for a specific date
get_daily_summary	Get a daily summary
get_projects	List projects
create_entry	Create a time entry
update_entry	Update a time entry
stop_entry	Stop the running time entry
delete_entry	Delete a time entry

License

MIT