> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://contentful.com/developers/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://contentful.com/_mcp/server.

# Installing the Contentful CLI

> This guide will help you installing the contentful-cli on your system | Local installation and alternative installation methods.

This lists the various ways you can install the `contentful-cli`.

## Local installation

Using [homebrew](https://brew.sh):

```bash
brew install contentful-cli
```

Using [npm](https://npmjs.org):

```bash
npm install -g contentful-cli
```

Using [yarn](https://yarnpkg.com):

```bash
yarn global add contentful-cli
```

> Please note that for the non-standalone versions you need a Node `LTS` release version to use the CLI.

## Use of cached version

Using [npx](https://github.com/npm/npx):

```bash
npx contentful-cli <cmd>
```

Show help output using [npx](https://github.com/npm/npx):

```bash
npx contentful-cli --help
```

## Alternative installation methods

Standalone installation on MacOS and Linux:

* Download the latest version of the executable for [Mac OS/Linux from Github](https://github.com/contentful/contentful-cli/releases/latest).
* Add the download directory to path export `PATH=$PATH:~/downloaddirectory`.
* You now have the Contentful CLI tool installed.

Standalone installation on Windows:

* Download the latest version of the .exe for [Windows from Github](https://github.com/contentful/contentful-cli/releases/latest).
* Add the executable to your Path:
  * Open the start menu and type "Edit environment variables"
  * Click "Edit environment variables for your account"
  * In the User variables box select the Path variable
  * Click "Edit..."
  * In the new dialog, click "New"
  * Add the location where you downloaded the .exe and click OK
  * Restart the system
* The Contentful CLI tool is installed

## Next steps

* [Handle authentication with the Contentful CLI](/tutorials/cli/authentication/)
* [Configure the Contentful CLI](/tutorials/cli/config-management)
* [Check out the documentation in the GitHub repository](https://github.com/contentful/contentful-cli/tree/master/docs)

> This guide will help you installing the contentful-cli on your system | Local installation and alternative installation methods.