Twitter Interaction MCP Server

CommunicationPython

Interact with Twitter to search tweets, view timelines, and analyze sentiment

Available Tools

search_twitter

Search for tweets matching a specific query

querycountsort_by

get_timeline

Retrieve tweets from your home timeline

Twikit is a Model Context Protocol server that enables AI assistants to interact with Twitter. It provides capabilities to search tweets, view your home timeline, and analyze sentiment across different Twitter accounts. This tool is particularly useful for monitoring social media presence, conducting sentiment analysis, and staying updated with your Twitter feed.

Overview

Twikit is a Model Context Protocol (MCP) server that allows AI assistants to interact with Twitter. It provides a set of tools for searching tweets, viewing your timeline, and analyzing Twitter content.

Installation

Option 1: Install via Smithery

The easiest way to install Twikit is through Smithery:

npx -y @smithery/cli install mcp-twikit --client claude

Option 2: Manual Installation

To manually install Twikit, add the following configuration to your AI assistant's settings:

{
    "mcpServer": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/adhikasp/mcp-twikit", "mcp-twikit"],
        "env": {
            "TWITTER_USERNAME": "@yourusername",
            "TWITTER_EMAIL": "your.email@example.com",
            "TWITTER_PASSWORD": "yourpassword"
        }
    }
}

Replace the environment variables with your actual Twitter credentials.

Configuration

Twikit requires your Twitter credentials to authenticate with the Twitter API. You need to provide:

TWITTER_USERNAME: Your Twitter handle (including the @ symbol)
TWITTER_EMAIL: The email address associated with your Twitter account
TWITTER_PASSWORD: Your Twitter password

These credentials are used to authenticate your requests to Twitter.

Usage Examples

Searching Tweets

You can search for tweets using specific queries:

search for the latest tweets about artificial intelligence

Viewing Your Timeline

To see what's happening on your Twitter timeline:

what is happening on my twitter timeline?

Sentiment Analysis

You can analyze sentiment across different Twitter accounts:

compare the latest tweets directed at @Company1, @Company2, and @Company3. What is the sentiment toward these brands?

Advanced Searches

You can perform more specific searches with parameters:

find the 20 most popular tweets about climate change from the past week

Privacy and Security

Please note that your Twitter credentials are used only for authentication purposes. It's recommended to use this tool with caution and ensure your credentials are stored securely.

Limitations

The tool may be subject to Twitter's rate limiting policies
Some advanced Twitter features might not be available
Performance may vary based on Twitter's API availability