Toggl Track Integration

Pro v1.0.0

Track time, manage projects, and analyze productivity with Toggl Track's time tracking API

Requires Claude Code CLI

This skill integrates with Toggl Track through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Show Current Time Entry

Display the currently running time entry with elapsed duration

Returns

object Current time entry details including description, start time, and duration

Try saying...

  • "What am I tracking right now?"
  • "Show my current Toggl timer"
  • "What's currently running in Toggl?"

Start Time Entry

Begin tracking a new task, optionally with project and tags

Parameters

Name Type Required Description
description string Required Task description
project string Optional Project name to associate with the entry
tags string Optional Comma-separated list of tags

Returns

object Created time entry with ID and details

Try saying...

  • "Start tracking 'Email responses'"
  • "Track time for 'Client meeting' in project 'Acme Corp'"
  • "Begin a timer for 'Code review' with tags 'development,review'"

Stop Current Entry

Stop the currently running time entry

Returns

object Stopped time entry with final duration

Try saying...

  • "Stop my Toggl timer"
  • "Stop tracking time"
  • "End the current time entry"

List Recent Entries

View recent time entries from the last N days

Parameters

Name Type Required Description
days integer Optional Number of days to look back

Returns

array List of time entries with descriptions and durations

Try saying...

  • "Show my time entries from the last 7 days"
  • "What did I track this week?"
  • "List my time entries from the past 14 days"

List Projects

View all projects in the workspace

Returns

array List of projects with names and status

Try saying...

  • "Show my Toggl projects"
  • "List all projects"
  • "What projects do I have in Toggl?"

List Workspaces

View all workspaces you have access to

Returns

array List of workspaces with names and IDs

Try saying...

  • "Show my Toggl workspaces"
  • "List my workspaces"
  • "What workspaces do I have access to?"

Getting Started

API Key Easy Setup
  1. 1 Log into Toggl Track at https://track.toggl.com
  2. 2 Go to Profile settings: https://track.toggl.com/profile
  3. 3 Scroll to the 'API Token' section
  4. 4 Click to reveal and copy your API token
  5. 5 Add to shell config: echo 'export TOGGL_API_TOKEN="YOUR_TOKEN"' >> ~/.zshrc
  6. 6 Restart terminal or run: source ~/.zshrc

Verify Setup

source ~/.config/claude-skills/toggl-track-api/.venv/bin/activate && python /workspace/webserver/lib/smartvox/skill_hub/skills/toggl-track-api/scripts/client.py workspaces

Success: Lists your Toggl workspaces

View full setup guide

Security & Access

Access Scope

Full access to user's Toggl Track account including time entries, projects, workspaces, and settings

  • API token grants complete access to your Toggl account
  • Never share your API token or commit it to version control
  • Token has same permissions as your user account
  • Consider regenerating token periodically for security

Limitations

  • Time entry queries limited to 1000 results
  • Rate limits vary by plan tier
  • Projects must exist before they can be associated with time entries

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
REST API
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
requests>=2.28.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements