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.
1---2name: twitter-automation3description: Automate Twitter/X tasks via Rube MCP (Composio): posts, search, users, bookmarks, lists, media. Always search tools first for current schemas.4---56# Twitter/X Automation via Rube MCP78Automate Twitter/X operations through Composio's Twitter toolkit via Rube MCP.910## Prerequisites1112- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)13- Active Twitter connection via `RUBE_MANAGE_CONNECTIONS` with toolkit `twitter`14- Always call `RUBE_SEARCH_TOOLS` first to get current tool schemas1516## Setup1718**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.1920211. Verify Rube MCP is available by confirming `RUBE_SEARCH_TOOLS` responds222. Call `RUBE_MANAGE_CONNECTIONS` with toolkit `twitter`233. If connection is not ACTIVE, follow the returned auth link to complete Twitter OAuth244. Confirm connection status shows ACTIVE before running any workflows2526## Core Workflows2728### 1. Create and Manage Posts2930**When to use**: User wants to create, delete, or look up tweets/posts3132**Tool sequence**:331. `TWITTER_USER_LOOKUP_ME` - Get authenticated user info [Prerequisite]342. `TWITTER_UPLOAD_MEDIA` / `TWITTER_UPLOAD_LARGE_MEDIA` - Upload media [Optional]353. `TWITTER_CREATION_OF_A_POST` - Create a new post [Required]364. `TWITTER_POST_LOOKUP_BY_POST_ID` - Look up a specific post [Optional]375. `TWITTER_POST_DELETE_BY_POST_ID` - Delete a post [Optional]3839**Key parameters**:40- `text`: Post text content (max 280 weighted characters)41- `media__media_ids`: Array of media ID strings for attachments42- `reply__in_reply_to_tweet_id`: Tweet ID to reply to43- `quote_tweet_id`: Tweet ID to quote44- `id`: Post ID for lookup/delete4546**Pitfalls**:47- Post text is limited to 280 weighted characters; some characters count as more than one48- Posting is NOT idempotent; retrying on timeout will create duplicate posts49- Media IDs must be numeric strings, not integers50- UPLOAD_LARGE_MEDIA is for videos/GIFs; UPLOAD_MEDIA for images51- Always call USER_LOOKUP_ME first to get the authenticated user's ID5253### 2. Search Posts5455**When to use**: User wants to find tweets matching specific criteria5657**Tool sequence**:581. `TWITTER_RECENT_SEARCH` - Search recent tweets (last 7 days) [Required]592. `TWITTER_FULL_ARCHIVE_SEARCH` - Search full archive (Academic access) [Optional]603. `TWITTER_RECENT_SEARCH_COUNTS` - Get tweet count matching query [Optional]6162**Key parameters**:63- `query`: Search query using Twitter search operators64- `max_results`: Results per page (10-100)65- `next_token`: Pagination token66- `start_time`/`end_time`: ISO 8601 time range67- `tweet__fields`: Comma-separated fields to include68- `expansions`: Related objects to expand6970**Pitfalls**:71- RECENT_SEARCH covers only the last 7 days; use FULL_ARCHIVE_SEARCH for older tweets72- FULL_ARCHIVE_SEARCH requires Academic Research or Enterprise access73- Query operators: `from:username`, `to:username`, `is:retweet`, `has:media`, `-is:retweet`74- Empty results return `meta.result_count: 0` with no `data` field75- Rate limits vary by endpoint and access level; check response headers7677### 3. Look Up Users7879**When to use**: User wants to find or inspect Twitter user profiles8081**Tool sequence**:821. `TWITTER_USER_LOOKUP_ME` - Get authenticated user [Optional]832. `TWITTER_USER_LOOKUP_BY_USERNAME` - Look up by username [Optional]843. `TWITTER_USER_LOOKUP_BY_ID` - Look up by user ID [Optional]854. `TWITTER_USER_LOOKUP_BY_IDS` - Batch look up multiple users [Optional]8687**Key parameters**:88- `username`: Twitter handle without @ prefix89- `id`: Numeric user ID string90- `ids`: Comma-separated user IDs for batch lookup91- `user__fields`: Fields to return (description, public_metrics, etc.)9293**Pitfalls**:94- Usernames are case-insensitive but must not include the @ prefix95- User IDs are numeric strings, not integers96- Suspended or deleted accounts return errors, not empty results97- LOOKUP_BY_IDS accepts max 100 IDs per request9899### 4. Manage Bookmarks100101**When to use**: User wants to save, view, or remove bookmarked tweets102103**Tool sequence**:1041. `TWITTER_USER_LOOKUP_ME` - Get authenticated user ID [Prerequisite]1052. `TWITTER_BOOKMARKS_BY_USER` - List bookmarked posts [Required]1063. `TWITTER_ADD_POST_TO_BOOKMARKS` - Bookmark a post [Optional]1074. `TWITTER_REMOVE_A_BOOKMARKED_POST` - Remove bookmark [Optional]108109**Key parameters**:110- `id`: User ID (from USER_LOOKUP_ME) for listing bookmarks111- `tweet_id`: Tweet ID to bookmark or unbookmark112- `max_results`: Results per page113- `pagination_token`: Token for next page114115**Pitfalls**:116- Bookmarks require the authenticated user's ID, not username117- Bookmarks are private; only the authenticated user can see their own118- Pagination uses `pagination_token`, not `next_token`119120### 5. Manage Lists121122**When to use**: User wants to view or manage Twitter lists123124**Tool sequence**:1251. `TWITTER_USER_LOOKUP_ME` - Get authenticated user ID [Prerequisite]1262. `TWITTER_GET_A_USER_S_OWNED_LISTS` - List owned lists [Optional]1273. `TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS` - List memberships [Optional]1284. `TWITTER_GET_A_USER_S_PINNED_LISTS` - Get pinned lists [Optional]1295. `TWITTER_GET_USER_S_FOLLOWED_LISTS` - Get followed lists [Optional]1306. `TWITTER_LIST_LOOKUP_BY_LIST_ID` - Get list details [Optional]131132**Key parameters**:133- `id`: User ID for listing owned/member/followed lists134- `list_id`: List ID for specific list lookup135- `max_results`: Results per page (1-100)136137**Pitfalls**:138- List IDs and User IDs are numeric strings139- Lists endpoints require the user's numeric ID, not username140141### 6. Interact with Posts142143**When to use**: User wants to like, unlike, or view liked posts144145**Tool sequence**:1461. `TWITTER_USER_LOOKUP_ME` - Get authenticated user ID [Prerequisite]1472. `TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID` - Get liked posts [Optional]1483. `TWITTER_UNLIKE_POST` - Unlike a post [Optional]149150**Key parameters**:151- `id`: User ID for listing liked posts152- `tweet_id`: Tweet ID to unlike153154**Pitfalls**:155- Like/unlike endpoints require user ID from USER_LOOKUP_ME156- Liked posts pagination may be slow for users with many likes157158## Common Patterns159160### Search Query Syntax161162**Operators**:163- `from:username` - Posts by user164- `to:username` - Replies to user165- `@username` - Mentions user166- `#hashtag` - Contains hashtag167- `"exact phrase"` - Exact match168- `has:media` - Contains media169- `has:links` - Contains links170- `is:retweet` / `-is:retweet` - Include/exclude retweets171- `is:reply` / `-is:reply` - Include/exclude replies172- `lang:en` - Language filter173174**Combinators**:175- Space for AND176- `OR` for either condition177- `-` prefix for NOT178- Parentheses for grouping179180### Media Upload Flow181182```1831. Upload media with TWITTER_UPLOAD_MEDIA (images) or TWITTER_UPLOAD_LARGE_MEDIA (video/GIF)1842. Get media_id from response1853. Pass media_id as string in media__media_ids array to TWITTER_CREATION_OF_A_POST186```187188## Known Pitfalls189190**Character Limits**:191- Standard posts: 280 weighted characters192- Some Unicode characters count as more than 1193- URLs are shortened and count as fixed length (23 characters)194195**Rate Limits**:196- Vary significantly by access tier (Free, Basic, Pro, Enterprise)197- Free tier: very limited (e.g., 1,500 posts/month)198- Check `x-rate-limit-remaining` header in responses199200**Idempotency**:201- Post creation is NOT idempotent; duplicate posts will be created on retry202- Implement deduplication logic for automated posting203204## Quick Reference205206| Task | Tool Slug | Key Params |207|------|-----------|------------|208| Create post | TWITTER_CREATION_OF_A_POST | text |209| Delete post | TWITTER_POST_DELETE_BY_POST_ID | id |210| Look up post | TWITTER_POST_LOOKUP_BY_POST_ID | id |211| Recent search | TWITTER_RECENT_SEARCH | query |212| Archive search | TWITTER_FULL_ARCHIVE_SEARCH | query |213| Search counts | TWITTER_RECENT_SEARCH_COUNTS | query |214| My profile | TWITTER_USER_LOOKUP_ME | (none) |215| User by name | TWITTER_USER_LOOKUP_BY_USERNAME | username |216| User by ID | TWITTER_USER_LOOKUP_BY_ID | id |217| Users by IDs | TWITTER_USER_LOOKUP_BY_IDS | ids |218| Upload media | TWITTER_UPLOAD_MEDIA | media |219| Upload video | TWITTER_UPLOAD_LARGE_MEDIA | media |220| List bookmarks | TWITTER_BOOKMARKS_BY_USER | id |221| Add bookmark | TWITTER_ADD_POST_TO_BOOKMARKS | tweet_id |222| Remove bookmark | TWITTER_REMOVE_A_BOOKMARKED_POST | tweet_id |223| Unlike post | TWITTER_UNLIKE_POST | tweet_id |224| Liked posts | TWITTER_RETURNS_POST_OBJECTS_LIKED_BY_THE_PROVIDED_USER_ID | id |225| Owned lists | TWITTER_GET_A_USER_S_OWNED_LISTS | id |226| List memberships | TWITTER_GET_A_USER_S_LIST_MEMBERSHIPS | id |227| Pinned lists | TWITTER_GET_A_USER_S_PINNED_LISTS | id |228| Followed lists | TWITTER_GET_USER_S_FOLLOWED_LISTS | id |229| List details | TWITTER_LIST_LOOKUP_BY_LIST_ID | list_id |230231## When to Use232This skill is applicable to execute the workflow or actions described in the overview.233234## Limitations235- Use this skill only when the task clearly matches the scope described above.236- Do not treat the output as a substitute for enprojectnment-specific validation, testing, or expert review.237- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
phoroth