How do I install the Toggl skill?

Run npx skillmds@latest add dvcrn/toggl in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Toggl safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Toggl?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Toggl free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Toggl by dvcrn — Agent Skill

Name: Toggl
Rating: 4.2 (5 reviews)
Author: dvcrn

Toggl

Track time with Toggl via the toggl CLI. Use when the user wants to start/stop time tracking, check current timer, view today's or weekly reports, list recent entries, or manage time entries. Triggers on "toggl", "time tracking", "timer", "track time", "what am I working on", "log time", "timesheet".

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

Toggl Time Tracking

Use the toggl CLI (@beauraines/toggl-cli) for Toggl Track integration.

Prerequisites

Install the CLI:

npm install -g @beauraines/toggl-cli

Configure authentication (create ~/.toggl-cli.json):

{
  "api_token": "YOUR_TOGGL_API_TOKEN",
  "default_workspace_id": "YOUR_WORKSPACE_ID",
  "timezone": "Your/Timezone"
}

Get your API token from: https://track.toggl.com/profile Get your workspace ID from your Toggl URL: https://track.toggl.com/{workspace_id}/...

Set permissions: chmod 600 ~/.toggl-cli.json

Commands

Status

toggl now                    # Show running timer
toggl me                     # Show user info

Start/Stop

toggl start                  # Start timer (interactive)
toggl start -d "Task name"   # Start with description
toggl start -d "Task" -p "Project"  # With project
toggl stop                   # Stop current timer

Continue Previous

toggl continue               # Restart most recent entry
toggl continue "keyword"     # Restart entry matching keyword

Reports

toggl today                  # Today's time by project
toggl week                   # Weekly summary by day

List Entries

toggl ls                     # Last 14 days
toggl ls -d 7                # Last 7 days
toggl ls --today             # Today only
toggl ls "search term"       # Search entries

Add Completed Entry

toggl add "9:00AM" "10:30AM" "Meeting notes"

Edit Current

toggl edit -s "10:00AM"      # Change start time
toggl edit -d "New desc"     # Change description
toggl edit -p "Project"      # Change project

Delete

toggl rm <id>                # Remove entry by ID

Projects

toggl project ls             # List projects

Other

toggl web                    # Open Toggl in browser
toggl create-config          # Generate config template

Notes

Times must be parsable by dayjs (e.g., 4:50PM, 12:00 AM, 9:00)
Config file: ~/.toggl-cli.json
Environment variables override config: TOGGL_API_TOKEN, TOGGL_DEFAULT_WORKSPACE_ID, TOGGL_TIMEZONE

---name: toggldescription: Track time with Toggl via the toggl CLI. Use when the user wants to start/stop time tracking, check current timer, view today's or weekly reports, list recent entries, or manage time entries. Triggers on "toggl", "time tracking", "timer", "track time", "what am I working on", "log time", "timesheet".---# Toggl Time TrackingUse the `toggl` CLI (@beauraines/toggl-cli) for Toggl Track integration.## PrerequisitesInstall the CLI:```bashnpm install -g @beauraines/toggl-cli```Configure authentication (create `~/.toggl-cli.json`):```json{ "api_token": "YOUR_TOGGL_API_TOKEN", "default_workspace_id": "YOUR_WORKSPACE_ID", "timezone": "Your/Timezone"}```Get your API token from: https://track.toggl.com/profileGet your workspace ID from your Toggl URL: `https://track.toggl.com/{workspace_id}/...`Set permissions: `chmod 600 ~/.toggl-cli.json`## Commands### Status```bashtoggl now # Show running timertoggl me # Show user info```### Start/Stop```bashtoggl start # Start timer (interactive)toggl start -d "Task name" # Start with descriptiontoggl start -d "Task" -p "Project" # With projecttoggl stop # Stop current timer```### Continue Previous```bashtoggl continue # Restart most recent entrytoggl continue "keyword" # Restart entry matching keyword```### Reports```bashtoggl today # Today's time by projecttoggl week # Weekly summary by day```### List Entries```bashtoggl ls # Last 14 daystoggl ls -d 7 # Last 7 daystoggl ls --today # Today onlytoggl ls "search term" # Search entries```### Add Completed Entry```bashtoggl add "9:00AM" "10:30AM" "Meeting notes"```### Edit Current```bashtoggl edit -s "10:00AM" # Change start timetoggl edit -d "New desc" # Change descriptiontoggl edit -p "Project" # Change project```### Delete```bashtoggl rm <id> # Remove entry by ID```### Projects```bashtoggl project ls # List projects```### Other```bashtoggl web # Open Toggl in browsertoggl create-config # Generate config template```## Notes- Times must be parsable by dayjs (e.g., `4:50PM`, `12:00 AM`, `9:00`)- Config file: `~/.toggl-cli.json`- Environment variables override config: `TOGGL_API_TOKEN`, `TOGGL_DEFAULT_WORKSPACE_ID`, `TOGGL_TIMEZONE`

Frequently asked questions