---
title: mssql-cli
description: 'mssql-cli is an interactive command-line query tool for SQL Server that runs on Windows, macOS, or Linux.'
ms.prod: sql
ms.prod_service: sql-tools
ms.technology: tools-other
ms.topic: conceptual
author: markingmyname
ms.author: maghan
ms.reviewer: alayu, sstein, maghan
ms.custom: tools|mssql-cli
ms.date: 02/22/2018
monikerRange: "=azuresqldb-current||=azure-sqldw-latest||>=sql-server-2016||=sqlallproducts-allversions||>=sql-server-linux-2017"
---

# mssql-cli command-line query tool for SQL Server (Preview)

[!INCLUDE[appliesto-ss-asdb-asdw-xxx-md](../includes/appliesto-ss-asdb-asdw-xxx-md.md)]

mssql-cli is an interactive command-line tool for querying SQL Server, install it on Windows, macOS, or Linux.

## Install mssql-cli

For detailed installation instructions, see the [Installation Guide](https://github.com/dbcli/mssql-cli/tree/master/doc/installation), or if you know pip, install by running the following command:

```$ pip install mssql-cli```

## mssql-cli documentation

Documentation for mssql-cli is located in the [mssql-cli GitHub repository](https://github.com/dbcli/mssql-cli).

- [Main page/readme](https://github.com/dbcli/mssql-cli)
- [Installation Guide](https://github.com/dbcli/mssql-cli/tree/master/doc/installation)
- [Usage Guide](https://github.com/dbcli/mssql-cli/blob/master/doc/usage_guide.md)

Additional documentation is located in the [doc folder](https://github.com/dbcli/mssql-cli/tree/master/doc).