Mastodon MCP server
Mastodon in any MCP client, through Memtro: Mastodon does not publish this server. Memtro's Mastodon connector reads Mastodon through its API with the credentials you connect, and one endpoint hands those tools, every other system you connect and Memtro's memory tools to Claude Code, Cursor, Claude Desktop or anything else that speaks Streamable HTTP, as you.
What the model can do
Mastodon, on the account's own server: the home timeline, an account's posts, a hashtag timeline, one post with its thread, search across accounts, hashtags and posts, notifications (who did what, not the post text) and scheduled posts; when you ask, can publish, schedule, edit and delete posts, cancel a scheduled post, favourite, boost, bookmark and pin posts, follow or unfollow accounts, set a private note on an account and dismiss a notification.
Reads
mastodon_home_timelineThe connected account's home timeline, newest first: posts and boosts from accounts it follows, with author, text, counts and links.mastodon_account_postsPosts by one account, newest first, by its id or its handle (@name or @name@server).mastodon_hashtag_timelineRecent public posts with a hashtag, newest first, as this server sees them; local limits it to this server's own accounts.mastodon_get_postOne post by id, and with thread true the posts above it (ancestors) and the replies below it (descendants), up to 40 of each.mastodon_searchSearch accounts, hashtags and posts.mastodon_notificationsThe account's notifications, newest first: mentions, replies, boosts, favourites, follows and follow requests…mastodon_scheduled_postsPosts scheduled to publish later, with when, visibility and text.
Acts, when you ask
These change something in Mastodon. The model is told to use them only when you ask for exactly that, and each one is granted by name: per team on a shared connection, by the owner on a personal one.
mastodon_publish_postPublishes a post as the connected account, or schedules it when scheduled_at is given (at least 5 minutes ahead).mastodon_edit_postEdits one of the connected account's own posts (text, content warning, sensitive flag, language); only the fields passed change.mastodon_delete_postPermanently deletes one of the connected account's own posts.mastodon_cancel_scheduled_postCancels a scheduled post so it is never published; it cannot be restored.mastodon_favourite_postFavourites a post as the connected account (the author is notified), or with undo true removes the favourite.mastodon_boost_postBoosts (reshares) a post to the connected account's followers and profile, publicly unless visibility says otherwise, and notifies its author…mastodon_bookmark_postBookmarks a post for the connected account (private; nobody is notified), or with undo true removes the bookmark.mastodon_pin_postPins one of the connected account's own posts to the top of its public profile, or with undo true unpins it.mastodon_follow_accountFollows an account as the connected account (the account is notified, and a locked account receives a follow request instead)…mastodon_set_account_noteSets the connected account's private note on another account (visible only to the connected account; nobody is notified).mastodon_dismiss_notificationDismisses one notification so it no longer appears in the account's list; nobody else is affected.
Connect it
First connect Mastodon on Dashboard → Connections, then add Memtro to your client once. The Mastodon tools appear alongside the tools of everything else you have connected; nothing is configured per connector.
Claude Code
The Memtro plugin registers the server and a skill for when to use it; the tools are then available in every session.
claude plugin marketplace add memtro-org/claude-memtro
claude plugin install memtro@memtro --config api_key=sk-memtro-...Cursor
Add the server to .cursor/mcp.json in the project, or to the global file under ~/.cursor/.
{
"mcpServers": {
"memtro": {
"url": "https://platform.memtro.com/api/mcp",
"headers": {
"Authorization": "Bearer sk-memtro-..."
}
}
}
}Claude Desktop
Create a personal API key on Dashboard → Profile → API keys. In Claude Desktop add an MCP server of type HTTP with URL https://platform.memtro.com/api/mcp and the header Authorization: Bearer sk-memtro-…
OpenCode
A remote server in opencode.json.
{
"mcp": {
"memtro": {
"type": "remote",
"url": "https://platform.memtro.com/api/mcp",
"headers": {
"Authorization": "Bearer sk-memtro-..."
}
}
}
}Pi
One command: pi mcp add memtro --url https://platform.memtro.com/api/mcp --bearer-token-env-var MEMTRO_API_KEY. Tools arrive as mcp__memtro__*. The pi-memtro extension registers it for you, alongside Memtro as the model.
Any other client
Add an MCP server of type HTTP (Streamable HTTP, stateless) at https://platform.memtro.com/api/mcp with the header Authorization: Bearer sk-memtro-.... Codex, Zed, Windsurf, Cline and the SDKs all take a remote server this way.
Who may use it
The key identifies the person, and the server offers that person the tools they may use everywhere else in Memtro. A shared Mastodon connection is used by the teams an administrator granted it to, tool by tool, on the Permissions page; a personal connection is used by its owner alone, and its tools that act stay off until the owner allows them. See Teams and permissions and Connectors.
Ask it like this
- › What did people reply to our launch post?
- › Who mentioned us this week?
- › What is being posted under #opensource today?
- › Which posts are scheduled for next week?
- › Schedule a post for Monday at 9am announcing the webinar.
Questions
- Is this an official Mastodon MCP server?
- No. It is Memtro's MCP server with Memtro's Mastodon connector behind it: the connector reads Mastodon through its API with the credentials you connect on Dashboard → Connections, and Mastodon publishes nothing here. The same endpoint carries every other system you connect and Memtro's memory tools.
- What does it cost?
- Nothing on top of Memtro. One price per organisation by its number of users, from $50 a month for up to 10 users after a 7-day free trial, with every connector, the MCP server, jobs and memory included. You bring your own model keys.
- Can it change anything in Mastodon?
- Only when you ask, and only what it has been granted: publish or schedule a post, or reply to one; edit one of your posts; delete one of your posts; cancel a scheduled post; favourite a post, or undo it; boost a post, or undo it; bookmark a post, or remove the bookmark; pin one of your posts to your profile, or unpin it; follow an account, or unfollow it; set a private note on an account; dismiss a notification. Every other tool reads, searches or lists. An administrator grants each acting tool by name per team, and a personal connection acts only after its owner allows it.
- Which clients work?
- Any MCP client that speaks Streamable HTTP: Claude Code, Cursor, Claude Desktop, OpenCode, Codex, Zed, Windsurf, Cline and the Anthropic and OpenAI SDKs. There is no local process to run; the server is remote and authenticated with your key.