Skip to content
A very simple Mastodon command-line client for posting toots.
Branch: master
Clone or download
glynnbird Merge pull request #15 from VonKavalier/patch-1
"Mastodon" instead of "Mastondon"
Latest commit b7038e5 Sep 18, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin 1.2.2 registration bug - fixes issue #11 Apr 21, 2017
.gitignore first commit Apr 11, 2017 Update Sep 18, 2018
app.js Allow connections to localhost/ Oct 22, 2017
package.json 1.2.3 Oct 23, 2017


A simple command-line utility that allows you to post a "toot" (equivalent of a Tweet) on the Mastodon social network.


npm install -g toot

Running first time

When you first run toot you will be asked some questions in order for toot to authenticate with your Mastodon service

> toot
Before you start using toot, you need to authenticate with your Mastodon server.

You will be asked for:

  • which instance of Mastodon are you posting to? - there are many e.g.
  • what name you want to give your app? - the name you pick here will show up in your Mastodon settings under "Authorized apps"

You will then be asked to visit a long URL in your browser and be prompted for one further piece of information:

  • the code displayed when you visit the URL?

This is a once-only operation. Then your configuration is saved (in ~/.mastodon.json).

Sending a toot

After the inital setup, sending a toot is a breeze:

> toot "I'm sending a Toot from the command-line!"

You can also pipe data from other processes into toot:

> cat longfile.txt | grep 'message' | toot


  • --visibility [direct|private|unlisted|public] - the visibility of the toot
  • --config [path] - location of the config file
  • --help - view help text
  • --version - show version number


> toot --visibility private "secret"
> toot --config ~/myconfig.json --visibility unlisted "hello there"

Why would I want this?

Perhaps you want to set up a Mastodon account for servers you are looking after. They can then be easily configured to send status updates:

> toot "$HOSTNAME is going down for maintenance. Farewell dear friends"
> toot "$HOSTNAME is up. I'm back!"


If you want to reconfigure Toot from the beginning, simply delete the ~/.mastodon.json file and run toot again to reauthorise.

You can’t perform that action at this time.