Get Started

Use the Tableau Server Client (TSC) library to increase your productivity as you interact with the Tableau Server REST API. With the TSC library you can do almost everything that you can do with the REST API, including:

This section describes how to:

Confirm prerequisites

Before you install TSC, confirm that you have the following dependencies installed:

Install TSC

You can install TSC with pip or from the source code.

Run the following command to install the latest stable version of TSC:

pip install tableauserverclient

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+

Note that the version from the development branch should not be used for production code. The methods and endpoints in the development version are subject to change at any time before the next stable release.

Get the samples

The TSC samples are included in the samples directory of the TSC repository on Github. You can run the following command to clone the repository:

git clone

For more information on the samples and how to run the samples, see Samples.

Write your first program

Run the following code to get a list of all the data sources on your installation of Tableau Server:

import tableauserverclient as TSC

tableau_auth = TSC.TableauAuth('USERNAME', 'PASSWORD')
server = TSC.Server('http://SERVER_URL')

with server.auth.sign_in(tableau_auth):
    all_datasources, pagination_item = server.datasources.get()
    print("\nThere are {} datasources on site: ".format(pagination_item.total_available))
    print([ for datasource in all_datasources])