Twitter Ai Agent

Twitter Ai Agent with Gemini Integration 🤖

[](https://opensource.org/licenses/MIT)

An intelligent Twitter (X) agent powered by Google's Gemini AI that allows you to post tweets using natural language commands. This project demonstrates the integration of AI with social media APIs to create powerful automation tools.

✨ Features

• Natural Language Processing: Post tweets using everyday language
• AI-Powered: Leverages Google's Gemini 2.0 Flash model
• Real-time Interaction: Command-line interface for seamless interaction
• Secure: Environment-based configuration for sensitive credentials
• Extensible: Built with a modular architecture for easy expansion

🛠️ Tech Stack

• Backend: Node.js, Express
• AI: Google Gemini 2.0 Flash
• APIs: Twitter API v2
• Protocol: Model Context Protocol (MCP)
• Authentication: OAuth 1.0a

📦 Prerequisites

• Node.js (v16+)
• npm or yarn
• Twitter Developer Account
• Google Cloud Project with Gemini API enabled

Installation

1. Clone the repository

``bash git clone https://github.com/adarshpheonix2810/Twitter-Ai-Agent.git cd Twitter-Ai-Agent ``

1. Install dependencies

```bash # Install server dependencies cd server npm install

# Install client dependencies cd ../client npm install ```

1. Set up environment variables

Create a .env file in both client and server directories:

client/.env `` GEMINI_API_KEY=your_gemini_api_key_here ``

server/.env `` TWITTER_API_KEY=your_twitter_api_key TWITTER_API_SECRET=your_twitter_api_secret TWITTER_ACCESS_TOKEN=your_twitter_access_token TWITTER_ACCESS_TOKEN_SECRET=your_twitter_access_token_secret ``

🏃‍♂️ Running the Application

1. Start the server

``bash cd server node index.js ``

1. In a new terminal, start the client

``bash cd client node index.js ``

1. Start interacting!

Type your message in the command line, for example: `` Post a tweet saying "Hello from my new AI Twitter agent! #AI #TwitterBot" ``

🛠️ Project Structure

twitter-ai-agent/
├── client/                   # Client application
│   ├── index.js             # Main client file
│   ├── package.json         # Client dependencies
│   └── .env                 # Client environment variables
├── server/                  # Server application
│   ├── index.js             # Main server file
│   ├── twittertool.js       # Twitter API integration
│   ├── package.json         # Server dependencies
│   └── .env                 # Server environment variables
├── .gitignore              # Git ignore file
└── README.md               # This file

🔒 Security Considerations

• Never commit your .env files
• Keep your API keys secure
• Use environment variables for all sensitive information
• Consider implementing user authentication for production use

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.

📧 Contact

Your Name - Adarsh Singh

Project Link: https://github.com/adarshpheonix2810/twitter-ai-agent

🙏 Acknowledgments

• Google Gemini
• Twitter API
• Model Context Protocol
• Node.js

🌟 Show your support

Give a ⭐️ if this project helped you!

---

Made with ❤️ by Adarsh Singh

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: adarshpheonix2810
• Source: adarshpheonix2810/Twitter-Ai-Agent
• License: MIT

Install and usage instructions live in the source repository linked above.