Twitter/X Automation via Rube MCP

Automate Twitter/X operations through Composio's Twitter toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/twitter

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 attachments

• reply__in_reply_to_tweet_id : Tweet ID to reply to

• quote_tweet_id : Tweet ID to quote

• id : 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 operators

• max_results : Results per page (10-100)

• next_token : Pagination token

• start_time /end_time : ISO 8601 time range

• tweet__fields : Comma-separated fields to include

• expansions : 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 @ prefix

• id : Numeric user ID string

• ids : Comma-separated user IDs for batch lookup

• user__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 bookmarks

• tweet_id : Tweet ID to bookmark or unbookmark

• max_results : Results per page

• pagination_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 lists

• list_id : List ID for specific list lookup

• max_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 posts

• tweet_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 user

• to:username

• Replies to user

• @username

• Mentions user

• #hashtag

• Contains hashtag

• "exact phrase"

• Exact match

• has:media

• Contains media

• has:links

• Contains links

• is:retweet / -is:retweet

• Include/exclude retweets

• is:reply / -is:reply

• Include/exclude replies

• lang: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

Powered by Composio