Can I use Mastodon as a CLI?

Yes. KosmoKrator exposes a Mastodon CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Mastodon through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Mastodon tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Mastodon credentials stored?

Mastodon credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Mastodon MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

social

Mastodon CLI for Headless Automation

Use the Mastodon CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

6 functions 5 read 1 write Bearer token auth

Submit Mastodon feedback View package source

Mastodon CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Mastodon CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Mastodon CLI for Headless Automation
kosmokrator integrations:configure mastodon --set access_token="$MASTODON_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call mastodon.mastodon_list_statuses '{"timeline":"example_timeline","limit":1,"max_id":"example_max_id","since_id":"example_since_id"}' --json

Discovery Before Execution

Agents and scripts can inspect Mastodon docs and schemas before choosing a function.

kosmo integrations:docs mastodon --json
kosmo integrations:docs mastodon.mastodon_list_statuses --json
kosmo integrations:schema mastodon.mastodon_list_statuses --json
kosmo integrations:search "Mastodon" --json
kosmo integrations:list --json

Useful Mastodon CLI Functions

Function	Type	Parameters	Description
`mastodon.mastodon_list_statuses`	Read	timeline, limit, max_id, since_id	Browse statuses (toots) from a Mastodon timeline. Use "home" for your home feed, "public" for the federated timeline, or "local" for the local instance timeline. Supports pagination.
`mastodon.mastodon_get_status`	Read	id	Retrieve a single Mastodon status (toot) by its ID. Returns the full post content, author details, and engagement metrics.
`mastodon.mastodon_create_status`	Write	status, visibility, in_reply_to_id, spoiler_text, sensitive, language	Publish a new status (toot) on Mastodon. Supports content warnings, visibility controls (public, unlisted, private, direct), replies, and language settings.
`mastodon.mastodon_list_accounts`	Read	id, limit, max_id	List followers of a Mastodon account. Returns account profiles with display names, bios, and follower counts. Supports pagination.
`mastodon.mastodon_get_account`	Read	id	Retrieve a Mastodon account profile by ID. Returns display name, bio, follower counts, and other profile details.
`mastodon.mastodon_get_current_user`	Read	none	Get the authenticated user's Mastodon profile. Returns display name, bio, follower/following counts, and other account details.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Mastodon CLI Pages

CI Mastodon CLI for CI. Cron Jobs Mastodon CLI for cron jobs. Shell Scripts Mastodon CLI for shell scripts. Coding Agents Mastodon CLI for coding agents.