Skip to content
Mastodon logo

Mastodon MCP server

Open-source decentralized social network

Mastodon is not a separate install. One Activepieces MCP server exposes it alongside 760+ other apps, behind a single URL.

Tools
14
Works with
Any MCP client
Auth
Custom auth
License
MIT, open source
Updated
October 2026

About the Mastodon MCP server

Connect Mastodon once in Activepieces and every action it ships becomes a tool your assistant can call, behind the same server URL as the rest of your apps. Your agent reaches Mastodon and 760+ other apps over a single connection, on our cloud or a self-hosted install.

Tools

Mastodon tools your AI can run

Once connected, your assistant can call any of these Mastodon actions by asking in plain language.

  • Post Status

    Post a status to Mastodon, optionally as a reply, with a content warning or with limited visibility.

    7 fields

  • Schedule Status

    Schedule a status to be published automatically at a future time.

    12 fields

  • Get Status

    Get a single status by its ID.

    1 field

  • Edit Status

    Edit the text, content warning, media or poll of one of your statuses.

    9 fields

  • Delete Status

    Permanently delete one of your own statuses.

    2 fields

  • Favourite Status

    Add a status to your favourites.

    1 field

  • Boost Status

    Boost (reblog) a status to your followers.

    2 fields

  • Upload Media

    Upload an image, video or audio file, then map its Media ID into Media IDs of Post Status, Schedule Status or Edit Status to attach it.

    3 fields

  • Lookup Account

    Find an account by its handle (username or user@domain) to get its Account ID for Follow Account and other steps.

    1 field

  • Follow Account

    Follow an account, or send a follow request to a locked account.

    4 fields

  • Unfollow Account

    Stop following an account.

    1 field

  • Get Hashtag Timeline

    Get recent public statuses that use a hashtag.

    11 fields

  • Search

    Search for accounts, statuses and hashtags.

    10 fields

  • Custom API Call

    Make a custom API call to a specific endpoint

    10 fields

Triggers

Mastodon events your agent can watch

These start a run the moment something happens in Mastodon, so work gets picked up on its own.

  • New Mention

    Triggers when someone mentions your account in a post, including replies and direct messages. On mastodon.social and other servers running Mastodon 4.3 or later, direct messages and mentions from accounts you do not follow may be held back by your notification filters (Preferences > Notifications) and will not trigger the flow until you accept them.

  • New Follower

    Triggers when someone starts following your account. If your account requires follow approval, people appear here only after you accept their request.

  • New Status from Account

    Triggers when a specific account publishes a new post. For accounts on other servers, only posts that reach your server are seen, so following the account makes this reliable.

    3 fields

  • New Status with Hashtag

    Triggers when a new public post uses a hashtag. Posts from other servers are included once they reach your server.

    3 fields

Give your assistant Mastodon

Connect Mastodon once and every tool above is callable from Claude, Cursor or any MCP client, behind the same server URL as 760+ other apps. Free to start.

Mastodon MCP, answered.

No. That is the point of it. One Activepieces server exposes Mastodon alongside every other piece you connect, so your client keeps a single connection.

Yes. Activepieces is open source and free to start, and the MCP server is included on every plan, from the free cloud tier to any self-hosted deployment.

Connect Mastodon in Activepieces, enable the server under Settings → MCP Server, then paste your server URL into your client config. It authenticates over OAuth on first use.

It can call 14 tools, including Post Status, Schedule Status, Get Status, and chain them with steps in other apps inside the same run.

Connections use OAuth2 with limited scopes and are stored under 256-bit encryption, with no API to read them back, so an agent gets scoped access rather than your keys.