❓ Frequently Asked Questions

Everything you need to know about XActions — the free, open-source X/Twitter automation toolkit.

💡 General

What is XActions?
XActions is a free, open-source X/Twitter automation toolkit with 43+ tools for unfollowing, scraping, auto-engaging, and more. It works through browser scripts, a CLI, and an MCP server for AI agents. No API fees, no accounts required.
Is XActions really free?
Yes, 100% free and open source under the MIT license. No hidden fees, no premium tiers, no credit system. Every feature is available to everyone.
Do I need a Twitter/X API key?
No. XActions uses browser automation — scripts run directly in your browser's DevTools console on x.com. You don't need an API key, developer account, or any special permissions.
Is XActions affiliated with X/Twitter?
No. XActions is an independent open-source project. It is not endorsed by or affiliated with X Corp in any way.

🔒 Safety & Security

Is my account safe?
XActions runs in your browser — your credentials never leave your machine. Scripts add human-like delays (1-3 seconds) between actions to avoid rate limits. However, any automation carries some risk; start with conservative settings.
Will I get banned or suspended?
XActions mimics human behavior with built-in delays. Thousands of users have used it without issues. That said, any automation carries some risk. Avoid running multiple scripts simultaneously, and start with small batches.
Do you store my data?
No. Browser scripts run entirely in your browser — nothing is sent to our servers. The CLI tool and MCP server both run locally on your machine. Your data stays with you.
Is the code safe to run?
Yes — it's fully open source. You can read every line of code on GitHub before running it. The project is MIT-licensed and community-audited.

🚀 Usage

How do I use XActions?
Three ways:

1. Browser Scripts — Copy-paste scripts into DevTools (F12) on x.com
2. CLI — Run npx xactions from your terminal
3. MCP Server — Use with AI agents like Claude, Cursor, or Windsurf

See the Tutorials for step-by-step guides.
What can I automate?
Unfollowing, following, liking, posting, scraping profiles/tweets/followers, detecting unfollowers, downloading videos, training your algorithm, auto-replying, and much more. See all 43+ features for the complete list.
How do I unfollow people who don't follow me back?
Go to x.com, open DevTools (F12), paste the unfollowback script, and run it. It will automatically check each account you follow and unfollow those who don't follow you back. See the unfollow tutorial for step-by-step instructions.
Can I schedule automations?
Yes. The MCP server and CLI can be combined with cron jobs or AI agents for scheduling. Browser scripts run on-demand when you paste them in DevTools.

🤖 MCP & AI Integration

What is the MCP server?
The Model Context Protocol (MCP) server lets AI assistants (Claude, Cursor, Windsurf) control Twitter actions through natural language. For example: "Unfollow everyone who hasn't tweeted in 6 months." It exposes 140+ tools that AI agents can call directly. See the MCP page for details.
How do I set up MCP with Claude Desktop?
Run npx xactions-mcp and add the config to Claude Desktop's settings. The setup takes about 30 seconds. See the MCP setup tutorial for the full guide.
Which AI tools work with XActions?
Any MCP-compatible client works, including Claude Desktop, Cursor, Windsurf, and VS Code with Copilot. XActions also has a standalone AI integration via OpenRouter for tweet generation and voice analysis.

⚙️ Technical

Which browsers are supported?
Chrome, Edge, Brave, and any Chromium-based browser. Firefox works for most scripts. Safari has limited support for some DevTools features.
Does it work on mobile?
Browser scripts require desktop DevTools, so they don't work on mobile. The CLI and MCP server work on any machine with Node.js installed.
What version of Node.js do I need?
Node.js 18 or higher is recommended for the CLI and MCP server. Browser scripts don't require Node.js at all.
How do I report a bug?
Open an issue on GitHub: github.com/nirholas/XActions/issues. Include steps to reproduce, your browser version, and any error messages.

Still have questions?

Ask the community or check the docs.

💬 Ask on GitHub 📚 Read the Docs