Skip to main content
Glama
enesjakozh

Mastodon MCP

by The-Focus-AI
GitHub
TypeScript
MIT License
4
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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
  • Schedule toots for a future time
  • Secure credential management using environment variables or 1Password CLI

Prerequisites

  • Node.js 18+
  • pnpm
  • A Mastodon account and API access token
  • Optionally, 1Password CLI (op) installed and configured if using 1Password for credential management.

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. You can provide this token in one of the following ways:

  1. Environment Variable (Recommended for simplicity): Set the MASTODON_ACCESS_TOKEN environment variable:
    export MASTODON_ACCESS_TOKEN="your_mastodon_api_token"
  2. 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
  • scheduled_at: Optional ISO 8601 datetime to schedule the toot for a future time (e.g., "2024-07-04T10:00:00-07:00")

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", "scheduled_at": "2025-01-01T12:00:00Z" }

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 can be securely managed via environment variables or retrieved from 1Password.
  • API responses are git-ignored to prevent accidental credential leaks

License

ISC

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

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.

Tools

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

                • mcp-server-code-assist

                  abhishekbhakat
                  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
                  1
                  MIT License
                  • Linux
                  • Apple

                • MCP Filesystem Server

                  safurrier
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that provides secure and intelligent interaction with files and filesystems, offering smart context management and token-efficient operations for working with large files and complex directory structures.
                  Last updated -
                  21
                  45
                  MIT License
                  • Apple
                  • Linux

                • MCP-Server-TESS

                  diegofornalha
                  -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that enables integration with the TESS API, allowing users to list and manage agents, execute agents with custom messages, and manage files through natural language interfaces.
                  Last updated -

                • Monad MCP Server

                  lispking
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI models to interact with the Monad testnet for checking token balances, sending transactions, and deploying smart contracts.
                  Last updated -
                  7
                  8
                  Apache 2.0

                View all related MCP servers

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/The-Focus-AI/mastodon-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server