Home/Mastodon
Mastodon Integration

Schedule Mastodon posts on any instance.

Connect a Mastodon account from mastodon.social, mas.to, hachyderm.io, or any server, and publish text, images, and video from the dashboard or any AI agent via MCP or REST API. Schedule in advance and post to Mastodon alongside all your other social platforms.

Everything you need for Mastodon

🌐

Works on any Mastodon instance

Connect from mastodon.social, mas.to, hachyderm.io, or your own server. Aidelly registers an OAuth app on each instance the first time you connect — no manual API key setup.

📅

Schedule statuses in advance

Queue days of Mastodon content with one click. Aidelly publishes at the exact time you specify and respects per-instance rate limits.

🖼️

Text, images, and video

Up to 4 images or a single video per status, with content warnings, language, and visibility (public, unlisted, followers-only, direct) honored on every post.

💬

Reply to mentions from the Inbox

Mentions and replies from your Mastodon server land in Aidelly’s Inbox alongside Instagram, Threads, and Google Business. Reply inline — Aidelly posts back to the right instance.

How to post to Mastodon with Aidelly

1

Connect your Mastodon instance

Go to Settings > Connected Accounts and click Connect Mastodon. Enter the host of your Mastodon server (the part after the @ in your handle). Aidelly will open your instance’s login page so you can authorize the app.

2

Compose your status

Write your post with text, images, video, and hashtags. Set visibility (public, unlisted, followers-only, direct), language, and an optional content warning. Use the dashboard or instruct your AI agent directly.

3

Schedule or publish immediately

Set a schedule_at timestamp to post later, or publish right away. Aidelly confirms delivery, logs the result, and records the public URL on your post record.

4

Reply to mentions from one Inbox

Mentions land in Aidelly’s Inbox alongside Instagram, Threads, and Google Business. Reply inline — Aidelly posts back to the right Mastodon instance with the visibility you choose.

Post to Mastodon via API

Any AI agent can post to Mastodon by calling the Aidelly API with mastodon in the platforms array:

curl -X POST https://api.aidelly.ai/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Shipped Mastodon support — full federated publishing.",
    "platforms": ["mastodon"],
    "platformSpecific": {
      "mastodon": {
        "visibility": "public",
        "language": "en"
      }
    },
    "schedule_at": "2026-04-01T09:00:00Z"
  }'

Supported content types

Text statuses (500 chars)
Image posts (up to 4)
Video posts
Content warnings (spoiler_text)
Per-status visibility
Per-status language
Mentions inbox + reply
Favourites / boosts analytics
Scheduled posts

Mastodon scheduling common questions

What types of Mastodon posts can Aidelly publish?

Aidelly supports text statuses (up to 500 characters by default), image posts (up to 4 images), and video posts on any Mastodon instance. Per-status visibility (public, unlisted, followers-only, direct), content warnings, and language are all supported.

How do I connect my Mastodon account?

Go to Settings > Connected Accounts and click Connect Mastodon. Enter your instance host (the part after the @ in your handle — e.g. mastodon.social, mas.to, hachyderm.io). Aidelly will open your instance’s login page in a popup so you can authorize the app.

Does Aidelly work with any Mastodon instance or just the popular ones?

Any Mastodon instance. Mastodon is federated, so every server hosts its own API. Aidelly registers an OAuth app on the instance the first time someone connects from it and caches the credentials per-host. If your instance runs the standard Mastodon API, it works.

Can I schedule Mastodon posts for a specific time?

Yes. Set a schedule_at timestamp when creating a post via the dashboard, API, or MCP. Aidelly holds the status and publishes at the exact time you specify.

Can an AI agent post to Mastodon automatically?

Yes. Any agent with access to Aidelly via MCP, REST API, or Claude Skill can create and schedule Mastodon statuses immediately or on a schedule without any human interaction.

What is the character limit for Mastodon?

mastodon.social and most instances cap statuses at 500 characters. Some instances raise that limit — Aidelly reads the per-instance limit at publish time and surfaces an error if your status would be rejected.

Does Aidelly support content warnings?

Yes. Set the spoiler_text / content warning per post in the composer or via the API’s platformSpecific field. Aidelly forwards it to the Mastodon API so subscribers see the warning before expanding the post.

Can I get analytics on my Mastodon posts?

Yes. Aidelly aggregates favourites, boosts (reblogs), and replies per status into the unified analytics dashboard. Mastodon does not expose impressions or reach publicly, so those columns stay empty.