← Back to directory
X

XActions

Community
The complete X/Twitter automation toolkit: scrape, post, schedule, analyze, engage. No API key required.
GitHub source repository ↗
★ 477 Stars Category · Other Very popular Source revision e6dada7e93f5
34FMRS · D
Reliability
6/20
Security and permissions
4/20
Maintenance
8/20
Documentation
8/20
Setup experience
8/20

XActions is a feature-rich, free, open-source MCP server for X/Twitter automation, providing 145+ tools that cover a wide range of operations. It bypasses the official API via browser automation, which eliminates the need for API keys but introduces potential compliance risks. It is excellent for individual developers and small projects due to its cost-effectiveness; however, it is less suitable for enterprise or compliance-heavy scenarios. Overall, it is a powerful and flexible tool, but users should be cautious about usage frequency to avoid account risks.

Read the FMRS scoring method →

XActions is an open-source, free MCP server for X/Twitter automation, offering 145+ tools across categories like scraping, analysis, actions, automation, AI, monitoring, workflows, personas, portability, Spaces, and social graph. It works without an API key by using browser automation instead of the official API, and provides multiple interfaces: CLI, Node.js library, browser scripts, and browser extension. This server enables AI agents like Claude or GPT to directly interact with X/Twitter, including fetching profiles, searching tweets, following/unfollowing, posting, sentiment analysis, and keyword monitoring.

Tools

x_get_profile
Fetches public profile information for a given user.
x_get_followers
Retrieves the list of followers for a user.
x_get_following
Retrieves the list of users a user follows.
x_get_tweets
Fetches tweets from a user.
x_search_tweets
Searches for tweets.
x_get_thread
Fetches the full content of a tweet thread.
x_download_video
Extracts video download URLs from a tweet.
x_get_replies
Fetches replies to a tweet.
x_get_hashtag
Fetches tweets under a hashtag.
x_get_likers
Fetches users who liked a tweet.
x_get_retweeters
Fetches users who retweeted a tweet.
x_get_media
Fetches media posts by a user.
x_get_mentions
Fetches tweets mentioning a user.
x_get_quote_tweets
Fetches tweets quoting a given tweet.
x_get_likes
Fetches tweets liked by a user.
x_get_recommendations
Fetches recommended users.
x_detect_unfollowers
Detects users who have unfollowed you.
x_analyze_sentiment
Analyzes sentiment of tweets or topics.
x_best_time_to_post
Analyzes the best time to post.
x_competitor_analysis
Analyzes competitor social media performance.
x_brand_monitor
Monitors brand mentions and sentiment.
x_audience_insights
Gets audience insights.
x_engagement_report
Generates engagement reports.
x_crypto_analyze
Analyzes cryptocurrency-related tweets.
x_follow
Follows a user.
x_unfollow
Unfollows a user.
x_like
Likes a tweet.
x_post_tweet
Posts a tweet.
x_post_thread
Posts a thread of tweets.
x_reply
Replies to a tweet.
x_retweet
Retweets a tweet.
x_quote_tweet
Quotes a tweet.
x_bookmark
Bookmarks a tweet.
x_send_dm
Sends a direct message.
x_create_poll
Creates a poll.
x_delete_tweet
Deletes a tweet.
x_auto_follow
Automatically follows users matching criteria.
x_follow_engagers
Follows users who engage with your tweets.
x_unfollow_all
Unfollows all users.
x_smart_unfollow
Smart unfollow: unfollows users after a certain number of days or criteria.
x_auto_comment
Automatically comments on tweets.
x_auto_retweet
Automatically retweets matching tweets.
x_auto_like
Automatically likes matching tweets.
x_unfollow_non_followers
Unfollows users who don't follow you back.
x_analyze_voice
Analyzes a user's writing style.
x_generate_tweet
Generates tweet suggestions.
x_summarize_thread
Summarizes a tweet thread.
x_rewrite_tweet
Rewrites a tweet.
x_detect_bots
Detects bot accounts.
x_find_influencers
Finds influencers.
x_smart_target
Smart targeting for potential followers.
x_grok_analyze_image
Analyzes images using Grok.
x_monitor_account
Monitors a specific account.
x_monitor_keyword
Monitors a specific keyword.
x_follower_alerts
Alerts for new followers.
x_track_engagement
Tracks engagement metrics.
x_monitor_reputation
Monitors reputation.
x_stream_start
Starts a real-time data stream.
x_workflow_create
Creates a workflow.
x_workflow_run
Runs a workflow.
x_workflow_list
Lists workflows.
x_workflow_actions
Performs workflow actions.
x_persona_create
Creates a persona.
x_persona_run
Runs a persona.
x_persona_edit
Edits a persona.
x_persona_list
Lists personas.
x_persona_presets
Gets persona presets.
x_export_account
Exports account data.
x_migrate_account
Migrates account data.
x_diff_exports
Compares exported data.
x_import_data
Imports data.
x_convert_format
Converts data formats.
x_get_spaces
Discovers live Spaces.
x_scrape_space
Scrapes Space metadata.
x_space_join
Joins a Space as an AI voice agent.
x_space_leave
Leaves the active Space and returns a session summary.
x_space_status
Gets agent status in the active Space.
x_space_transcript
Gets recent transcriptions from the active Space.
x_graph_build
Builds a social graph.
x_graph_analyze
Analyzes a social graph.
x_graph_recommendations
Generates recommendations based on the graph.
x_graph_list
Lists graphs.

Setup

  1. Ensure Node.js (>=18) is installed.
  2. Run the MCP server using npx: npx -y xactions-mcp.
  3. Configure your MCP client (like Claude Desktop) with the following JSON in its config file:

{
"mcpServers": {
"xactions": {
"command": "npx",
"args": ["-y", "xactions-mcp"],
"env": {
"XACTIONS_SESSION_COOKIE": "your_auth_token_here"
}
}
}
}

  1. Optionally, log in to x.com, copy the auth_token cookie and set it as an environment variable.
claude_desktop_config.json
{
  "mcpServers": {
    "xactions": {
      "command": "npx",
      "args": [
        "-y",
        "xactions-mcp"
      ],
      "env": {
        "XACTIONS_SESSION_COOKIE": "your_auth_token_here"
      }
    }
  }
}

Fit and risk

Best for

  • Individual developers or small teams needing low-cost or zero-cost Twitter automation.
  • Developers wanting to integrate Twitter data into AI workflows.
  • Scraping projects that need fast Twitter data without official API access.
  • Personal brand managers looking to automate account growth (auto-follow, auto-like).

Not for

  • Enterprise applications that require stable and compliant official API access.
  • Users sensitive to automation risks or needing strict adherence to Twitter's terms of service.
  • Enterprises that need production-grade real-time data streams and advanced API features.
  • Organizations with strict compliance and security requirements, as browser automation may violate platform policies.

Required permissions

  • Requires access to X/Twitter authentication cookies (auth_token or X_COOKIES) to log in and perform actions.
  • May need username and password for login.
  • No access to local files or other system permissions.
  • When using browser automation, a browser instance runs locally in the background.

Risks and side effects

  • Using browser automation may violate X/Twitter's terms of service and could lead to account suspension or restrictions.
  • Automated activities may be detected by the platform's risk control systems.
  • The code explicitly states it is for educational and research purposes; use at your own risk.
  • Stolen cookies could compromise the account if not handled securely.

Troubleshooting

  1. Ensure the auth_token is correctly obtained by checking cookies in x.com's DevTools.
  2. Check Node.js version (>=18) if commands fail to run.
  3. If tool calls fail, try re-logging in or updating the cookie.
  4. For large operations, add appropriate delays (2-5 seconds) to avoid rate limits.
  5. If you encounter 'module not found', try `npx -y xactions-mcp` to force the latest version.

Use cases

Automate X/Twitter account management, like mass unfollowing, auto-liking, auto-following.
Scrape and analyze tweets, profiles, and hashtags for market research or social listening.
Let AI agents (like Claude) perform complex Twitter operations as instructed, e.g., generating tweets, analyzing competitors.
Monitor keywords, accounts, and engagement in real-time and get alerts.
Deploy AI voice agents in X Spaces for interactive audio conversations.

Supported clients

Claude DesktopFull support
CursorFull support
WindsurfFull support