| name | twitter-automation |
| description | Automate Twitter/X tasks via Rube MCP (Composio): posts, search, users, bookmarks, lists, media. Always search tools first for current schemas. |
| risk | critical |
| source | community |
| date_added | 2026-02-27 |
Twitter/X Automation via Rube MCP
Automate Twitter/X operations through Composio's Twitter toolkit via Rube MCP.
Prerequisites
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Twitter connection via
RUBE_MANAGE_CONNECTIONS with toolkit twitter
- Always call
RUBE_SEARCH_TOOLS first to get current tool schemas
Setup
Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
- Verify Rube MCP is available by confirming
RUBE_SEARCH_TOOLS responds
- Call
RUBE_MANAGE_CONNECTIONS with toolkit twitter
- If connection is not ACTIVE, follow the returned auth link to complete Twitter OAuth
- Confirm connection status shows ACTIVE before running any workflows
Core Workflows
1. Create and Manage Posts
When to use: User wants to create, delete, or look up tweets/posts
Tool sequence:
TWITTER_USER_LOOKUP_ME - Get authenticated user info [Prerequisite]TWITTER_UPLOAD_MEDIA / TWITTER_UPLOAD_LARGE_MEDIA - Upload media [Optional]TWITTER_CREATION_OF_A_POST - Create a new post [Required]TWITTER_POST_LOOKUP_BY_POST_ID - Look up a specific post [Optional]TWITTER_POST_DELETE_BY_POST_ID - Delete a post [Optional]
Key parameters:
text: Post text content (max 280 weighted characters)media__media_ids: Array of media ID strings for attachmentsreply__in_reply_to_tweet_id: Tweet ID to reply toquote_tweet_id: Tweet ID to quoteid: Post ID for lookup/delete
Pitfalls:
- Post text is limited to 280 weighted characters; some characters count as more than one
- Posting is NOT idempotent; retrying on timeout will create duplicate posts
- Media IDs must be numeric strings, not integers
- UPLOAD_LARGE_MEDIA is for videos/GIFs; UPLOAD_MEDIA for images
- Always call USER_LOOKUP_ME first to get the authenticated user's ID
2. Search Posts
When to use: User wants to find tweets matching specific criteria
Tool sequence:
TWITTER_RECENT_SEARCH - Search recent tweets (last 7 days) [Required]TWITTER_FULL_ARCHIVE_SEARCH - Search full archive (Academic access) [Optional]TWITTER_RECENT_SEARCH_COUNTS - Get tweet count matching query [Optional]
Key parameters:
query: Search query using Twitter search operatorsmax_results: Results per page (10-100)next_token: Pagination tokenstart_time/end_time: ISO 8601 time rangetweet__fields: Comma-separated fields to includeexpansions: Related objects to expand
Pitfalls:
- RECENT_SEARCH covers only the last 7 days; use FULL_ARCHIVE_SEARCH for older tweets
- FULL_ARCHIVE_SEARCH requires Academic Research or Enterprise access
- Query operators:
from:username, to:username, is:retweet, has:media, -is:retweet
- Empty results return
meta.result_count: 0 with no data field
- Rate limits vary by endpoint and access level; check response headers
3. Look Up Users
When to use: User wants to find or inspect Twitter user profiles
Tool sequence:
TWITTER_USER_LOOKUP_ME - Get authenticated user [Optional]TWITTER_USER_LOOKUP_BY_USERNAME - Look up by username [Optional]TWITTER_USER_LOOKUP_BY_ID - Look up by user ID [Optional]TWITTER_USER_LOOKUP_BY_IDS - Batch look up multiple users [Optional]
Key parameters:
username: Twitter handle without @ prefixid: Numeric user ID stringids: Comma-separated user IDs for batch lookupuser__fields: Fields to return (description, public_metrics, etc.)
Pitfalls:
- Usernames are case-insensitive but must not include the @ prefix
- User IDs are numeric strings, not integers
- Suspended or deleted accounts return errors, not empty results
- LOOKUP_BY_IDS accepts max 100 IDs per request
4. Manage Bookmarks
When to use: User wants to save, view, or remove bookmarked tweets
Tool sequence:
TWITTER_USER_LOOKUP_ME - Get authenticated user ID [Prerequisite]TWITTER_BOOKMARKS_BY_USER - List bookmarked posts [Required]TWITTER_ADD_POST_TO_BOOKMARKS - Bookmark a post [Optional]TWITTER_REMOVE_A_BOOKMARKED_POST - Remove bookmark [Optional]
Key parameters:
id: User ID (from USER_LOOKUP_ME) for listing bookmarkstweet_id: Tweet ID to bookmark or unbookmarkmax_results: Results per pagepagination_token: Token for next page
Pitfalls:
- Bookmarks require the authenticated user's ID, not username
- Bookmarks are private; only the authenticated user can see their own
- Pagination uses
pagination_token, not next_token
5. Manage Lists
When to use: User wants to view or manage Twitter lists
Tool sequence:
TWITTER_USER_LOOKUP_ME - Get authenticated user ID [Prerequisite]TWITTER_GET_A_USER_S_OWNED_LISTS - List owned lists [Optional]TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS - List memberships [Optional]TWITTER_GET_A_USER_S_PINNED_LISTS - Get pinned lists [Optional]TWITTER_GET_USER_S_FOLLOWED_LISTS - Get followed lists [Optional]TWITTER_LIST_LOOKUP_BY_LIST_ID - Get list details [Optional]
Key parameters:
id: User ID for listing owned/member/followed listslist_id: List ID for specific list lookupmax_results: Results per page (1-100)
Pitfalls:
- List IDs and User IDs are numeric strings
- Lists endpoints require the user's numeric ID, not username
6. Interact with Posts
When to use: User wants to like, unlike, or view liked posts
Tool sequence:
TWITTER_USER_LOOKUP_ME - Get authenticated user ID [Prerequisite]TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID - Get liked posts [Optional]TWITTER_UNLIKE_POST - Unlike a post [Optional]
Key parameters:
id: User ID for listing liked poststweet_id: Tweet ID to unlike
Pitfalls:
- Like/unlike endpoints require user ID from USER_LOOKUP_ME
- Liked posts pagination may be slow for users with many likes
Common Patterns
Search Query Syntax
Operators:
from:username - Posts by userto:username - Replies to user@username - Mentions user#hashtag - Contains hashtag"exact phrase" - Exact matchhas:media - Contains mediahas:links - Contains linksis:retweet / -is:retweet - Include/exclude retweetsis:reply / -is:reply - Include/exclude replieslang:en - Language filter
Combinators:
- Space for AND
OR for either condition- prefix for NOT- Parentheses for grouping
Media Upload Flow
1. Upload media with TWITTER_UPLOAD_MEDIA (images) or TWITTER_UPLOAD_LARGE_MEDIA (video/GIF)
2. Get media_id from response
3. Pass media_id as string in media__media_ids array to TWITTER_CREATION_OF_A_POST
Known Pitfalls
Character Limits:
- Standard posts: 280 weighted characters
- Some Unicode characters count as more than 1
- URLs are shortened and count as fixed length (23 characters)
Rate Limits:
- Vary significantly by access tier (Free, Basic, Pro, Enterprise)
- Free tier: very limited (e.g., 1,500 posts/month)
- Check
x-rate-limit-remaining header in responses
Idempotency:
- Post creation is NOT idempotent; duplicate posts will be created on retry
- Implement deduplication logic for automated posting
Quick Reference
| Task | Tool Slug | Key Params |
|---|
| Create post | TWITTER_CREATION_OF_A_POST | text |
| Delete post | TWITTER_POST_DELETE_BY_POST_ID | id |
| Look up post | TWITTER_POST_LOOKUP_BY_POST_ID | id |
| Recent search | TWITTER_RECENT_SEARCH | query |
| Archive search | TWITTER_FULL_ARCHIVE_SEARCH | query |
| Search counts | TWITTER_RECENT_SEARCH_COUNTS | query |
| My profile | TWITTER_USER_LOOKUP_ME | (none) |
| User by name | TWITTER_USER_LOOKUP_BY_USERNAME | username |
| User by ID | TWITTER_USER_LOOKUP_BY_ID | id |
| Users by IDs | TWITTER_USER_LOOKUP_BY_IDS | ids |
| Upload media | TWITTER_UPLOAD_MEDIA | media |
| Upload video | TWITTER_UPLOAD_LARGE_MEDIA | media |
| List bookmarks | TWITTER_BOOKMARKS_BY_USER | id |
| Add bookmark | TWITTER_ADD_POST_TO_BOOKMARKS | tweet_id |
| Remove bookmark | TWITTER_REMOVE_A_BOOKMARKED_POST | tweet_id |
| Unlike post | TWITTER_UNLIKE_POST | tweet_id |
| Liked posts | TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID | id |
| Owned lists | TWITTER_GET_A_USER_S_OWNED_LISTS | id |
| List memberships | TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS | id |
| Pinned lists | TWITTER_GET_A_USER_S_PINNED_LISTS | id |
| Followed lists | TWITTER_GET_USER_S_FOLLOWED_LISTS | id |
| List details | TWITTER_LIST_LOOKUP_BY_LIST_ID | list_id |
When to Use
This skill is applicable to execute the workflow or actions described in the overview.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for enprojectnment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
