Skip to content

Remote Command Line Interface (CLI)

Mezzanine Client CLI is a remote CLI for Mezzanine API. It enables a user or service to remotely read or write to Mezzanine CMS using the command line. For example, you can write an article in Markdown on your laptop and type a simple command to automatically upload it and create a new blog post from it on your website.


$ pip install -U mezzanine-client


Refer to Mezzanine Client Prerequisites.


Generally, you must set at least three configuration options: API URL, OAuth App ID, and OAuth App Secret. These settings correspond to the location of your Mezzanine API instance and your OAuth credentials to authenticate with it (as was discussed further in the above Prerequisites section).

$ mezzanine-cli config api_url
$ mezzanine-cli config client_id id
$ mezzanine-cli config client_secret secret

You can also see your current configuration and available options by issuing the mezzanine-cli config command without any arguments. Note that the refresh_token setting should not be altered.

Authorize the app

Run a command that attempts to access the API:

$ mezzanine-cli posts list

Then follow the guide to authorize the app.

Getting started

Some examples:

# List all posts (most recent first).
$ mezzanine-cli posts list

# Get the post with the ID of 2.
$ mezzanine-cli posts get 2

# Create a post from a Markdown file.
$ mezzanine-cli posts create \
  --title='Test Post from API Client' \
  --content-file=~/Desktop/ \
  --categories='Test,Fun' \

Just add --help to any command in order to get help on the command line:

# General help.
$ mezzanine-cli

# View available options for creating posts.
$ mezzanine-cli posts create --help

Finally, if you wish to clear the credentials and reset CLI configuration, you can do so by running:

$ mezzanine-cli logout


Join us in the Mezzanine API chat room or leave a message and we will try to get back to you.

Feel free to star Mezzanine Client on Github to show your support and monitor updates.

Please file a ticket or contribute a pull request on GitHub for bugs or feature requests.


  • Add further CLI resources to interact with the API