Best for
- Individuals or small teams who want to automate X accounts without paying X API fees
- Developers using MCP clients like Claude Desktop, Cursor
- Users managing multiple X accounts
X
X-use
Community
Browser-native AI agents for X (Twitter): multi-account, MCP-ready, no X API key required.
GitHub source repository ↗
55FMRS · C
x-use is an open-source, MIT-licensed MCP server that automates X (Twitter) without an API key via browser automation. It provides 33 MCP tools, supports multi-account, draft approval, proxy management, and integrates with clients like Claude Desktop. Main risk is X account suspension, suitable for individuals and small teams.
x-use drives a real, stealth-hardened browser instead of the paid X API. It posts, replies, searches, and engages across as many accounts as you configure. It writes content with your own LLM and exposes everything as MCP tools, so Claude Desktop, Claude Code, Cursor, and other MCP clients can run your X presence directly. By default, write actions go through a draft-approval step, so an agent can prepare work all day while nothing reaches X until a human says yes.
Tools
list_accounts
List all configured accounts.
get_account
Get a single account's full masked configuration.
get_metrics
Get metrics (e.g., counters) for a specified account.
search_tweets
Search tweets using keywords.
search_profile
Search user profiles.
get_tweet
Get tweet details, including images.
prepare_reply
Prepare a reply draft for a tweet (requires approval).
list_queue
List the scheduled action queue.
list_drafts
List drafts pending approval.
get_draft
Get draft details.
reject_draft
Reject a draft.
get_run_status
Get background run status.
get_account_health
Check account health status.
list_proxies
List configured proxy pools.
post_tweet
Post a tweet (draft by default).
generate_and_post
Generate and post a tweet (requires LLM key, draft by default).
reply_to_tweet
Reply to a tweet (draft by default).
engage
Perform engagement actions like likes, retweets (draft by default).
run_cycle
Run an automation cycle (e.g., keyword replies).
approve_draft
Approve a draft and actually execute the publish/engage action.
queue_post
Queue a post for later.
queue_engagement
Queue an engagement action.
cancel_queued_action
Cancel a queued action.
process_queue
Process the queue of pending actions.
research_and_stage
Use server-side LLM to research and stage drafts.
draft_post_variations
Use server-side LLM to generate draft post variations.
add_account
Add a new account.
update_account
Update account configuration.
set_account_active
Activate or deactivate an account.
remove_account
Remove an account.
add_proxy
Add a proxy.
remove_proxy
Remove a proxy.
test_proxy
Test proxy connectivity.
Setup
- Install with pip install x-use-mcp. 2. Run x-use init for interactive setup wizard. 3. Run x-use doctor to verify environment. 4. Add {"mcpServers": {"x-use": {"command": "x-use", "args": ["mcp"]}}} to your MCP client config (e.g., Claude Desktop). 5. Restart the client.
claude_desktop_config.json
{
"mcpServers": {
"x-use": {
"command": "x-use",
"args": [
"mcp"
]
}
}
}
Fit and risk
Not for
- Enterprises requiring full official X API features (analytics, ads)
- Users concerned about X account suspension due to browser automation risks
- Users needing production-scale deployment, as Docker is not yet available
Required permissions
- Requires X account cookies for browser session
- Requires Chrome browser
- Optional: LLM API key (only for server-side text generation)
- Optional: Proxy (recommended for multi-account)
Risks and side effects
- X accounts may be suspended for violating terms of service
- Browser automation may be detected by X, leading to bans
- Cookies and credentials may be exposed despite masking
- Draft mode is on by default, but if turned off, publish actions will execute directly
Troubleshooting
- Run x-use doctor to check environment
- Ensure Chrome is installed and compatible
- Check draft_mode setting in config/settings.json
- Ensure MCP client can find x-use command (PATH)
- Check logs/accounts/<account_id>.jsonl logs
Use cases
Automate posting and replying on X
Manage multiple accounts with separate configurations
Keyword search, targeted engagement, and content curation
Control X accounts directly from MCP clients like Claude Desktop
Supported clients
Claude DesktopFull support