Interact with Mastodon instances from the command line using tootstream.
Open source
24 alternativesmadonctl
The Mastodon API is accessible from a terminal through madonctl, a Go command-line client.
About madonctl
madonctl is a command-line client, written in Go, for the Mastodon REST API. It lets users post toots, manage their account, and work with notifications, blocked and muted accounts, and their own posts from a terminal. It is built on madon, the author's Go implementation of the Mastodon API.
To use it, you specify an instance name or URL and provide an account login and password or a token. Settings can be passed as command-line arguments, set as environment variables, or stored in a configuration file, which madonctl can generate. For accounts with two-factor authentication, the documentation describes OAuth2 login through the oauth2 command. The project is open source, and the repository includes pre-built binaries and build-from-source instructions.
Key features
- Post toots with chosen visibility, content warnings, and media files
- Send message text from a file or from standard input
- Reply to a post, optionally adding mentions from the original post
- List, clear, and dismiss notifications
- List blocked and muted accounts
- Update display name, bio, avatar, bot flag, and default post settings
Best for: Developers and terminal users who want to script or automate Mastodon account actions through the API.
Good for
- Open source, with the source code available on GitHub
- Installable with the Go toolchain or from pre-built binaries
- Supports OAuth2 login for accounts with two-factor authentication
Watch out for
- Requires an instance name or URL and an account login or token
- By default sends a single query; the --all flag is needed for all results
madonctl at a glance
- Website
- github.com/McKael/madonctl
- Category
- Social & Communities › Fediverse
- Type
- Open-source project
- Pricing
- Not confirmed. Check the site
- Open source
- Yes · Source code
- Language
- English
- Last checked
- Oct 6, 2026 · Online when checked
- Listed
- Oct 5, 2026
madonctl alternatives
Tools and sites you could use instead, ranked by how closely they match.
Elk Native is a native version of Elk, described as a Mastodon web client.
Open source
24 alternatives
toot provides command-line and text-interface tools for interacting with Mastodon instances.
Open source
24 alternatives
Brutaldon provides a brutalist web interface for browsing and using Mastodon.
Use a terminal interface for Mastodon with Tut, which has vim-inspired keyboard controls.
Open source
24 alternatives
Build JavaScript integrations with the Mastodon API using masto.js, a universal client library.
Open source
24 alternativesPopular in Fediverse
Well-known listings from the same topic.
Mastodonaddons.mozilla.org/firefox/addon/mastodon-simp…Fediverse Observerfediverse.observerBridgy Fedfed.brid.gyAwesome Mastodongithub.com/hyperupcall/awesome-mastodonMasto.hostmasto.hostMastodonjoinmastodon.org
madonctl FAQ
How do I log in if two-factor authentication is enabled?
The source describes using OAuth2 with the oauth2 command, for example: madonctl -i mastodon.social oauth2 > madonctl.yaml.
How do I get all results from a list command?
By default madonctl sends a single query. Adding the --all flag retrieves all available results. A --limit value may cause several queries until that number of results is reached.
Is something wrong or out of date?
Tell us and an editor will check it.
Own this website?
Claim this listing
Claim the listing and suggest updates yourself. An editor checks every claim first.