Mastodon MCP

by The-Focus-AI

Integrations

  • Used for secure credential management to store and retrieve Mastodon API tokens, ensuring secure access to Mastodon accounts without hardcoding credentials.

  • Provides tools for posting content to Mastodon, including creating toots with customizable visibility and content warnings, uploading and attaching media files (images, videos, audio), and adding alt text to media attachments.

Mastodon MCP

A Model Context Protocol server that provides tools for interacting with Mastodon. Currently supports creating toots with optional media attachments.

Features

  • Create toots with customizable visibility and content warnings
  • Upload and attach media files (images, videos, audio)
  • Add alt text/descriptions to media attachments
  • Secure credential management using 1Password CLI

Prerequisites

  • Node.js 18+
  • pnpm
  • 1Password CLI (op) installed and configured
  • A Mastodon account and API access token

Installation

# Clone the repository git clone [repository-url] cd mastodon-mcp # Install dependencies pnpm install # Build the project pnpm build

Configuration

The tool requires a Mastodon API token stored in 1Password. Store your token at:

  • op://Personal/Floss.Social Key/notesPlain

You can optionally set the Mastodon instance URL via environment variable:

export MASTODON_INSTANCE_URL="https://your.instance.social"

If not set, it defaults to https://floss.social.

Usage

Start the MCP server:

pnpm start

The server exposes a single tool mastodon_create_toot with the following parameters:

  • content (required): The text content of your toot
  • visibility: One of "public", "unlisted", "private", or "direct" (default: "public")
  • sensitive: Boolean flag for sensitive content (default: false)
  • spoiler_text: Warning text shown before the content (default: "")
  • media_file: Path to a media file to attach
  • media_description: Alt text/description for the attached media

Example Usage with MCP Inspector

  1. Start the inspector:
npx @modelcontextprotocol/inspector node dist/mcp-server.js
  1. Open http://localhost:5173 in your browser
  2. Use the tool with parameters like:
{ "content": "Hello from MCP!", "visibility": "public", "media_file": "/path/to/image.jpg", "media_description": "A beautiful sunset" }

Development

# Run in development mode with auto-reloading pnpm dev # Build the project pnpm build # Run the built server pnpm start

Security

  • No credentials are hardcoded in the codebase
  • API tokens are securely stored in and retrieved from 1Password
  • API responses are git-ignored to prevent accidental credential leaks

License

ISC

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A Model Context Protocol server that provides tools for interacting with Mastodon, enabling users to create toots with customizable visibility and attach media files with descriptions.

  1. Features
    1. Prerequisites
      1. Installation
        1. Configuration
          1. Usage
            1. Example Usage with MCP Inspector
          2. Development
            1. Security
              1. License

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
                  Last updated -
                  12
                  Python
                  MIT License
                  • Linux
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
                  Last updated -
                  1
                  TypeScript
                  MIT License
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that enables enhanced file system operations including reading, writing, copying, moving files with streaming capabilities, directory management, file watching, and change tracking.
                  Last updated -
                  12
                  6
                  TypeScript
                  MIT License
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server providing utility tools for development and testing, offering functionalities like personalized greetings, random card drawing, and datetime formatting with an extensible architecture.
                  Last updated -
                  19
                  105
                  2
                  TypeScript
                  MIT License
                  • Apple
                  • Linux

                View all related MCP servers

                ID: aa8nqef2kx