mastodon-mcp

Overview

The mastodon-mcp server provides a specialized interface for interacting with the Mastodon social media platform through Model Context Protocol. It enables users to create toots with various visibility settings, attach media files with descriptions, and schedule posts for future publication. The server supports both environment variable and 1Password CLI for secure credential management, demonstrating good security practices.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• mastodon_create_tootcontent (required), visibility (optional), sensitive (optional), spoiler_text (optional), media_file (optional), media_description (optional), scheduled_at (optional)

  Create toots with customizable visibility, content warnings, and media attachments

  Try:Post a public toot saying 'Hello from MCP!'Try:Create a private toot with an image attachment and descriptionTry:Schedule a toot about my new project for next week

Comparable tools

Installation

# Clone the repository
git clone [repository-url]
cd mastodon-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

# Configuration
export MSTODON_ACCESS_TOKEN="your_mastodon_api_token"
export MASTODON_INSTANCE_URL="https://your.instance.social"  # Optional

# Start the server
pnpm start

{
  "mcpServers": {
    "mastodon": {
      "command": "node",
      "args": ["path/to/mastodon-mcp/dist/mcp-server.js"]
    }
  }
}

FAQ

What Mastodon instances are supported?

The server defaults to https://floss.social but can be configured to work with any Mastodon instance by setting the MASTODON_INSTANCE_URL environment variable.

What media types are supported?

The server supports images, videos, and audio files for attachment to toots.

How are credentials securely managed?

Credentials can be provided via environment variables or retrieved from 1Password CLI. No credentials are hardcoded in the codebase.

Compare mastodon-mcp with