Skip to main content

Interact with Mastodon social networks from the command line.

Project description

Interact with Mastodon social networks from the command line.


Install using pip:

pip install toot


Running toot displays a list of available commands.

Running toot <command> -h shows the documentation for the given command.

Command Description
toot login Log into a Mastodon instance.
toot 2fa Log into a Mastodon instance using two factor authentication.
toot logout Log out, deletes stored access keys.
toot auth Display stored authenitication tokens.
toot whoami Display logged in user details.
toot post Post a status to your timeline.
toot search Search for accounts or hashtags.
toot timeline Display recent items in your public timeline.
toot follow Follow an account.
toot unfollow Unfollow an account.


Before tooting, you need to login to a Mastodon instance:

toot login

Two factor authentication is supported experimentally, instead of login, you should instead run:

toot 2fa

You will be asked to chose an instance and enter your credentials.

The application and user access tokens will be saved in two files in your home directory:

  • ~/.config/toot/instances/<name> - created for each mastodon instance once
  • ~/.config/toot/user.cfg

You can check whether you are currently logged in:

toot auth

And you can logout which will remove the stored access tokens:

toot logout

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for toot, version 0.7.0
Filename, size File type Python version Upload date Hashes
Filename, size toot-0.7.0-py2.py3-none-any.whl (10.8 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size toot-0.7.0.tar.gz (8.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page