# Toggl command reference

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

HTML reference: https://www.productivity-bot.com/docs/toggl/

A question mark after an option means it is optional.

## /toggl account

Check the connected Toggl account.

```text
/toggl account visibility?
```

### Options

- `visibility` (Optional): 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.

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

### Options

- `project` (Optional): The Toggl project to use, create, list, or inspect.
- `description` (Optional): Optional extra details that explain the item more clearly than the short title alone.
- `billable` (Optional): Marks a Toggl time entry as billable or non-billable.
- `visibility` (Optional): 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.

```text
/toggl timer active visibility?
```

### Options

- `visibility` (Optional): 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.

```text
/toggl timer stop visibility?
```

### Options

- `visibility` (Optional): 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.

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

### Options

- `start` (Required): The start time for a manually inserted Toggl time entry.
- `stop` (Required): The stop time for a manually inserted Toggl time entry.
- `project` (Optional): The Toggl project to use, create, list, or inspect.
- `description` (Optional): Optional extra details that explain the item more clearly than the short title alone.
- `tags` (Optional): One or more Toggl tags to attach to a time entry.
- `billable` (Optional): Marks a Toggl time entry as billable or non-billable.
- `visibility` (Optional): 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.

```text
/toggl timer list visibility?
```

### Options

- `visibility` (Optional): 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.

```text
/toggl project create name visibility?
```

### Options

- `name` (Required): The name of the list, project, tag, or other resource being created or updated.
- `visibility` (Optional): 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.

```text
/toggl project list visibility?
```

### Options

- `visibility` (Optional): 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.

```text
/toggl project show project visibility?
```

### Options

- `project` (Required): The Toggl project to use, create, list, or inspect.
- `visibility` (Optional): 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.

```text
/toggl tag add name visibility?
```

### Options

- `name` (Required): The name of the list, project, tag, or other resource being created or updated.
- `visibility` (Optional): 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.

```text
/toggl tag show tag visibility?
```

### Options

- `tag` (Required): The Toggl tag to inspect.
- `visibility` (Optional): 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.