name: mastodon
description: Enables Claude to manage Mastodon toots, boosts, and fediverse engagement
version: 1.0.0
author: Canifi
category: social

Mastodon Skill

Overview

Automates Mastodon operations including creating toots, boosting content, managing follows, and engaging with the fediverse through browser automation.

Quick Install

curl -sSL https://canifi.com/skills/mastodon/install.sh | bash

Or manually:

cp -r skills/mastodon ~/.canifi/skills/

Setup

Configure via canifi-env:

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set MASTODON_INSTANCE "mastodon.social"
canifi-env set MASTODON_EMAIL "[email protected]"
canifi-env set MASTODON_PASSWORD "your-password"

Privacy & Authentication

Your credentials, your choice. Canifi LifeOS respects your privacy.

Option 1: Manual Browser Login (Recommended)

If you prefer not to share credentials with Claude Code:
1. Complete the Browser Automation Setup using CDP mode
2. Login to the service manually in the Playwright-controlled Chrome window
3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

If you're comfortable sharing credentials, you can store them locally:

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.

Capabilities

• Create and publish toots
• Boost and favorite posts
• Reply to toots
• Follow/unfollow accounts
• Search users and hashtags
• Manage lists
• View local and federated timelines
• Handle content warnings

Usage Examples

Example 1: Create a Toot

User: "Post to Mastodon about the open source project"
Claude: I'll create that toot.
- Navigate to Mastodon instance
- Click compose
- Write post about project
- Add relevant hashtags
- Publish toot

Example 2: Boost Content

User: "Boost that interesting toot about federated networks"
Claude: I'll boost that toot.
- Find the original toot
- Click boost button
- Confirm boosted
- Verify in your profile

Example 3: Search Hashtags

User: "Find posts tagged #opensource on Mastodon"
Claude: I'll search that hashtag.
- Navigate to search
- Search #opensource
- Browse results
- Present interesting toots

Example 4: View Federated Timeline

User: "Show me what's happening on the federated timeline"
Claude: I'll check the federated feed.
- Navigate to federated timeline
- Browse recent posts
- Summarize trending topics
- Note interesting accounts

Authentication Flow

1. Navigate to instance URL via Playwright MCP
2. Enter email and password from canifi-env
3. Handle 2FA if enabled (notify user via iMessage)
4. Verify home timeline access
5. Maintain session cookies

Error Handling

• Login Failed: Verify instance and credentials
• Session Expired: Re-authenticate automatically
• 2FA Required: iMessage for verification code
• Instance Down: Try later or notify user
• Federation Issue: Some content may not be available
• Rate Limited: Implement backoff
• User Not Found: Check instance and username format
• Content Warning Required: Add CW if needed

Self-Improvement Instructions

When encountering new Mastodon features:
1. Document instance-specific UI elements
2. Add support for new post types
3. Log successful federation patterns
4. Update for Mastodon updates

Notes

• Different instances have different rules
• Username format: @user@instance
• Content warnings are cultural norm
• Local timeline shows same-instance posts
• Federated timeline shows connected instances
• Some instances are invite-only
• Alt text encouraged for images