name: twitter-dms
description: Enables Claude to send Twitter/X direct messages and manage private conversations
version: 1.0.0
author: Canifi
category: communication

Twitter/X DMs Skill

Overview

Automates Twitter/X Direct Message operations including sending DMs, managing conversations, handling message requests, and group DM management through browser automation.

Quick Install

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

Or manually:

cp -r skills/twitter-dms ~/.canifi/skills/

Setup

Configure via canifi-env:

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

canifi-env set TWITTER_USERNAME "your-username"
canifi-env set TWITTER_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

• Send direct messages to followers/following
• Create and manage group DMs
• Respond to message requests
• Search DM history
• Share tweets via DM
• Send images and GIFs in DMs
• React to messages
• Manage DM settings and filters

Usage Examples

Example 1: Send a DM

User: "DM @techfriend about the conference next week"
Claude: I'll send that direct message.
- Navigate to twitter.com/messages
- Search for @techfriend
- Open or start conversation
- Send message about conference
- Confirm message delivered

Example 2: Create Group DM

User: "Create a Twitter group DM with @alex and @jordan for the podcast"
Claude: I'll create that group conversation.
- Click compose new message
- Add @alex and @jordan
- Name group "Podcast Discussion"
- Send initial message
- Confirm group created

Example 3: Check Message Requests

User: "Check my Twitter message requests"
Claude: I'll review your message requests.
- Navigate to message requests
- List pending message requests
- Summarize who's trying to reach you
- Await instruction to accept or decline

Example 4: Share Tweet via DM

User: "Share that viral tweet to @bestfriend via DM"
Claude: I'll share that tweet.
- Copy tweet link
- Open DM with @bestfriend
- Paste tweet link (embeds automatically)
- Add comment if requested
- Send message

Authentication Flow

1. Navigate to twitter.com/login via Playwright MCP
2. Enter username/email from canifi-env
3. Enter password
4. Handle phone/email verification if prompted
5. Complete 2FA if enabled (notify user via iMessage)
6. Verify access to messages tab
7. Maintain session cookies

Error Handling

• Login Failed: Try email instead of username, retry
• Session Expired: Re-authenticate automatically
• 2FA Required: iMessage for authentication code
• Verification Required: Notify user to check email/phone
• DM Restricted: User may not accept DMs from non-followers
• Rate Limited: Wait 15+ minutes before retry
• User Not Found: Verify username spelling
• Account Locked: Notify user to verify account

Self-Improvement Instructions

When encountering new X/Twitter DM features:
1. Document new UI selectors
2. Add support for new message types
3. Log successful DM patterns
4. Update for API/UI changes

Notes

• DMs only possible with users who allow them
• Some accounts restrict DMs to followers
• X Premium may have different DM limits
• Message requests go to separate folder
• Twitter frequently changes UI/branding
• Rate limits are strictly enforced
• GIF sending uses Twitter's GIF search