Twitter MCP Tool

Twitter MCP Tool

This repository contains the Twitter MCP Tool, a tool designed to streamline social media tasks using Python. It includes features for tweeting, username change history, Fetch recent tweets, and Send a direct message to a user.

Features

1. Tweet Posting

Post tweets with or without images directly to Twitter.

2. Query Username Changes

Track the username change history of any Twitter account.

3. Fetch Recent Tweets

Retrieve the latest tweets from any public Twitter user's timeline.

4. Send a Direct Message (DM)

Send a private message directly to a Twitter user.

Installing Dependencies and Running

1. Clone the repo using
   git clone https://github.com/jalaj-pandey/twitter-mcp-tool.git
2. Install dependencies:
   uv venv .venv\Scripts\activate pip install -r requirements.txt mcp dev script.py
   And if you want to install it in the claude desktop then use
   pip install script.py
3. Create a .env file with the following keys:
   X_api_key=<your_twitter_api_key> X_api_key_sec=<your_twitter_api_secret> X_access_token=<your_twitter_access_token> X_access_token_sec=<your_twitter_access_token_secret> X_bearer_token=<your_twitter_bearer_token> GEMINI_API_KEY=<your_gemini_api_key>

Usage

Open your claude desktop you will see the Twitter MCP Tool` is ready to use.

If not then Copy paste the config.json into your claude_desktop_config.json

Folder Structure