Skip to content

Toggl command reference

Manage Toggl timers, time entries, projects and tags from Discord.

A question mark after an option means it is optional.

Read as Markdown

/toggl account

Check the connected Toggl account.

Usage

/toggl account visibility?

Options

visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl timer start

Start a Toggl timer.

Usage

/toggl timer start project? description? billable? visibility?

Options

projectOptional
The Toggl project to use, create, list, or inspect.
descriptionOptional
Optional extra details that explain the item more clearly than the short title alone.
billableOptional
Marks a Toggl time entry as billable or non-billable.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl timer active

Show the currently active Toggl timer.

Usage

/toggl timer active visibility?

Options

visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl timer stop

Stop the active Toggl timer.

Usage

/toggl timer stop visibility?

Options

visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl timer insert

Manually insert a time entry.

Usage

/toggl timer insert start stop project? description? tags? billable? visibility?

Options

startRequired
The start time for a manually inserted Toggl time entry.
stopRequired
The stop time for a manually inserted Toggl time entry.
projectOptional
The Toggl project to use, create, list, or inspect.
descriptionOptional
Optional extra details that explain the item more clearly than the short title alone.
tagsOptional
One or more Toggl tags to attach to a time entry.
billableOptional
Marks a Toggl time entry as billable or non-billable.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl timer list

List recent Toggl timers.

Usage

/toggl timer list visibility?

Options

visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl project create

Create a Toggl project.

Usage

/toggl project create name visibility?

Options

nameRequired
The name of the list, project, tag, or other resource being created or updated.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl project list

List Toggl projects.

Usage

/toggl project list visibility?

Options

visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl project show

Inspect a Toggl project.

Usage

/toggl project show project visibility?

Options

projectRequired
The Toggl project to use, create, list, or inspect.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl tag add

Create or add a Toggl tag.

Usage

/toggl tag add name visibility?

Options

nameRequired
The name of the list, project, tag, or other resource being created or updated.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.

/toggl tag show

Inspect a Toggl tag.

Usage

/toggl tag show tag visibility?

Options

tagRequired
The Toggl tag to inspect.
visibilityOptional
Controls who can see the bot's response. In a server, Private (only me) shows the reply only to you; Public (channel) shows it in the channel. It does not change task scope or send the reply by DM.