Skip to main content
AI/MLjavimosch

minipostiz-mastodon-setup

Mastodon API setup for minipostiz-cli — create application, get access token, store instance URL + token

Stars
37
Source
javimosch/supercli
Updated
2026-05-31
Slug
javimosch--supercli--mastodon-setup
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/javimosch/supercli/HEAD/plugins/minipostiz-cli/skills/mastodon-setup/SKILL.md -o .claude/skills/mastodon-setup.md

Drops the SKILL.md into .claude/skills/mastodon-setup.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

minipostiz-cli — Mastodon Setup

Mastodon is federated — your instance URL matters. Each instance has its own API.

What you need

Credential Flag
Instance URL --instanceUrl (e.g. https://mastodon.social)
Access Token --accessToken

Step 1 — Create an Application on your instance

  1. Log in to your Mastodon instance (e.g. https://mastodon.social)
  2. Go to Preferences → Development → New application
  3. Fill in:
    • Application name: minipostiz
    • Website: any URL
    • Redirect URI: leave as urn:ietf:wg:oauth:2.0:oob
    • Scopes: check write:statuses and write:media (uncheck everything else)
  4. Click Submit
  5. Click the app name → copy Your access token

The access token shown on the app page is already authorized for your account — no OAuth flow needed.

Step 2 — Store in minipostiz-cli

minipostiz auth --platform mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "YOUR_ACCESS_TOKEN"

# Or via supercli
sc minipostiz auth set-mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "YOUR_ACCESS_TOKEN"

Replace mastodon.social with your actual instance domain.

Step 3 — Test

minipostiz auth verify --platform mastodon
minipostiz publish --platform mastodon --message "Hello from minipostiz-cli"

Visibility options

Store a default visibility by adding it to auth:

minipostiz auth --platform mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "TOKEN" \
  --visibility "unlisted"   # public | unlisted | private | direct

Troubleshooting

Error Cause Fix
401 Unauthorized Invalid token Regenerate token in Preferences → Development
422 Unprocessable Missing write:statuses scope Recreate app with correct scopes
Connection refused Wrong instance URL Verify URL includes https:// and no trailing slash issues

Token lifetime

Mastodon access tokens do not expire unless the application is deleted or access is revoked.