Mastodon MCP Server: Install & Setup

Install Mastodon in Claude Code

Claude Code

claude mcp add mastodon -- npx -y @mrfentmen/mastodon-mcp

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "mastodon": {
      "command": "npx",
      "args": [
        "-y",
        "@mrfentmen/mastodon-mcp"
      ]
    }
  }
}

Frequently asked questions

What does the Mastodon MCP server do?

Mastodon instance info and trends. No key required.

Is the Mastodon MCP server free?

Yes, most likely. Open source and no paid account or API key is mentioned in the listing. Check the provider for current pricing.

Does Mastodon run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Mastodon to Claude Code?

Run: claude mcp add mastodon -- npx -y @mrfentmen/mastodon-mcp

More social media MCP servers

View all

TryPost

788

trypostit/trypost

Run social media with agents. Connect over MCP to plan, write, and post to every network.

RemoteAccount needed

TokPortal

17.9k

tokportal/tokportal-mcp

Managed TikTok, Instagram and YouTube accounts run by TokPortal's human account managers, with video upload, scheduling, analytics and webhooks.

Local + RemoteAccount neededTypeScript

Facebook

232

HagaiHen/facebook-mcp-server

Manage Facebook Page posts, comments and engagement metrics through the Graph API.

LocalAccount neededPython

Xquik

225

Xquik-dev/x-twitter-scraper

X (Twitter) automation: post tweets, reply, like, retweet, follow, DM, search, extract data, run giveaways and monitor accounts.

RemoteAccount neededTypeScript

Taisly Social Media Posting

222

taisly/agent

Publish or schedule social videos to TikTok, Instagram Reels, YouTube Shorts, X and Facebook through Taisly, with account discovery and video validation.

Local + RemoteAccount neededTypeScript

posterly

06.1k

awpthorp/posterly-mcp-server

Validate, schedule, publish, and analyze social content across 18 platforms with posterly.

Local + RemoteFree