Home / Claude Code / Mastodon
Claude Code + Mastodon Skill

Claude Code + Mastodon Post to the Fediverse with AI

Use the Upload-Post skill to publish text toots, photos, and videos to Mastodon directly from Claude Code. Post to any instance in the fediverse using your instance URL and access token, no bespoke API code required.

Get Started Free View Docs

Install in Seconds

Works with Claude Code, Cursor, Windsurf, and any AI coding agent that supports skills.

Terminal
$ npx skills add Upload-Post/upload-post-skill

What You Can Post to Mastodon

Text
Photos
Videos

Features for Mastodon

Everything you need to publish and automate Mastodon content from your terminal.

Text Toots

Publish toots with full support for links, mentions, and hashtags. Formatting is preserved exactly as your Mastodon instance renders it.

Photo Posts

Attach images to your toots with support for JPEG, PNG, GIF, and WebP. Media is uploaded to your instance and displayed inline in the timeline.

Video Posts

Share video content natively to Mastodon. Upload videos that play inline in the timeline, reaching the fediverse with engaging multimedia.

Any Instance

Connect any Mastodon instance using its URL and an access token. It works with mastodon.social, niche community servers, and your own self-hosted instance alike.

Fediverse Reach

Your toots federate across the wider fediverse network, reaching followers on other instances that connect to Mastodon through the ActivityPub protocol.

Multi-Platform Reach

Publish the same update to Mastodon and other platforms in a single call, so your announcement lands across the fediverse and your other channels at once.

How It Works

1

Install the Skill

Run the install command in your terminal. The skill is added to Claude Code instantly.

2

Connect Mastodon

Link your Mastodon account on the Upload-Post dashboard and create a profile with your API key.

3

Publish from Claude Code

Tell your AI agent to post content to Mastodon. It handles formatting, uploading, and publishing automatically.

Start Posting to Mastodon from Claude Code

Join thousands of developers automating their social media workflow with AI. Free plan available.

Create Free Account View on GitHub

Prefer another integration path? Explore the Mastodon Upload API or the Mastodon MCP server.

Also Works With

One skill, 22 platforms. The same install command covers your entire social media stack.

TikTok Instagram YouTube LinkedIn Facebook X Threads Pinterest Reddit Bluesky Discord Telegram Slack Nostr Lemmy Dev.to Hashnode WordPress Whop Listmonk

Frequently Asked Questions

How does posting to Mastodon work through Claude Code?
Upload-Post handles the Mastodon API behind a simple interface. When you tell Claude Code to post to Mastodon, the skill sends your content to the Upload-Post API, which publishes it to your instance using your instance URL and access token. The toot appears in your timeline just as if you posted it from the Mastodon web app.
Which Mastodon instances are supported?
Any of them. Because you connect with your instance URL and an access token, the integration works with large servers like mastodon.social, small community instances, and self-hosted deployments. You are not tied to a single provider.
How do I authenticate with Mastodon?
Mastodon through Upload-Post uses your instance URL and a personal access token. You create the token in your instance developer settings, connect it to Upload-Post, and you can publish immediately without writing any API code or managing an app review.
What media formats does the Mastodon integration support?
Mastodon through Upload-Post supports text toots, photo posts (JPEG, PNG, GIF, WebP), and video posts. You can publish a text toot on its own or attach media to it, respecting the standard upload limits of your instance.
Can I cross-post to Mastodon and other platforms simultaneously?
Yes. Upload-Post supports multi-platform publishing in a single API call. Include multiple platforms in your request, such as platform[]=mastodon&platform[]=bluesky&platform[]=x, and your content is published to all of them at once. Each platform receives properly formatted content that respects its specific requirements.