Tableau provides the tabcmd command-line interface that you can use to automate site administration tasks on your Tableau Cloud or Tableau Server site. For example, you can use tabcmd to create or delete users, projects, and groups.

Install tabcmd

You can download and run tabcmd 2.0 as an executable file, or install it on the command line with pip.

Install with pip

For macOS and Linux, run the following command to install the latest stable version of tabcmd:

pip install tabcmd

Install from the development branch

You can install from the development branch for a preview of upcoming features. Run the following command to install from the development branch:

pip install git+
Important: Do not use the version from the development branch for production code. The methods in the development version are subject to change at any time.

Install the older tabcmd client

If you would like to install an older version of tabcmd, you can continue to follow the instructions at

Logging in

You can log in to the tabcmd CLI in one of four ways:


The following command demonstrates starting a session:

tabcmd login -s <> -t mysite -u -p password

Here’s how to start a session and delete a workbook with one command. Note that you do not need login here:

tabcmd delete "Sales_Workbook" -s <> -t campaign -u -p password

The options -s, -t, -u, and -p are among the tabcmd global variables, which can be used with any command.

For more information, see tabcmd Commands.