Twikit

by adhikasp

149 stars
401 downloads
Not rated
GitHub

About

Integrate with X (Twitter) for social media data analysis.

Details

Author
adhikasp
Repository
adhikasp/mcp-twikit
GitHub stars
149
Downloads
401
License
MIT License
Categories
Productivity, Developer Tools, Design, AI, Community, Media, Search, Infrastructure, Project Management, API, Other

- Search tweets by query and sort by latest.
- Retrieve tweets from your own home timeline.
- Compare sentiments across multiple Twitter accounts.
- Example usage with mcp-client-cli.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Twikit
    Command (node, npx, python, etc.) uvx
    Arguments
    • Argument 1 --from
    • Argument 2 git+https://github.com/adhikasp/mcp-twikit
    • Argument 3 mcp-twikit
    Environment
    • TWITTER_EMAIL me@example.com
    • TWITTER_PASSWORD secret
    • TWITTER_USERNAME @example

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

To install Twikit Twitter Search for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-twikit --client claude
{
    "mcpServer": {
        "command": "uvx",
        "args": ["--from", "git+https://github.com/adhikasp/mcp-twikit", "mcp-twikit"],
        "env": {
            "TWITTER_USERNAME": "@example",
            "TWITTER_EMAIL": "me@example.com",
            "TWITTER_PASSWORD": "secret",
        }
    }
}

Using mcp-client-cli

compare

Compare sentiments across different Twitter accounts. Parameters: latest tweet count (integer), accounts (string).

search_twitter

Search for tweets directed at a specific Twitter account. Parameters: query (string), count (integer), sort_by (string).

get_timeline

Retrieve the latest tweets from your Twitter timeline. No parameters required.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "twikit": {
            "env": {
                "TWITTER_EMAIL": "me@example.com",
                "TWITTER_PASSWORD": "secret",
                "TWITTER_USERNAME": "@example"
            },
            "args": [
                "--from",
                "git+https://github.com/adhikasp/mcp-twikit",
                "mcp-twikit"
            ],
            "command": "uvx"
        }
    }
}

Linux

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

Macos

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

Windows

{
    "env": {
        "TWITTER_EMAIL": "me@example.com",
        "TWITTER_PASSWORD": "secret",
        "TWITTER_USERNAME": "@example"
    },
    "args": [
        "--from",
        "git+https://github.com/adhikasp/mcp-twikit",
        "mcp-twikit"
    ],
    "command": "uvx"
}
# MCP-Twikit [![smithery badge](https://smithery.ai/badge/mcp-twikit)](https://smithery.ai/server/mcp-twikit) A Model Context Protocol (MCP) server for interacting with Twitter. <a href="https://glama.ai/mcp/servers/49i9dd08w8"><img width="380" height="200" src="https://glama.ai/mcp/servers/49i9dd08w8/badge" alt="mcp-twikit MCP server" /></a> ## Installation ### Installing via Smithery To install Twikit Twitter Search for Claude Desktop automatically via [Smithery](https://smithery.ai/server/mcp-twikit): ```bash npx -y @smithery/cli install mcp-twikit --client claude ``` ### Manual Installation ```json { "mcpServer": { "command": "uvx", "args": ["--from", "git+https://github.com/adhikasp/mcp-twikit", "mcp-twikit"], "env": { "TWITTER_USERNAME": "@example", "TWITTER_EMAIL": "me@example.com", "TWITTER_PASSWORD": "secret", } } } ``` ## Example usage Using [mcp-client-cli](https://github.com/adhikasp/mcp-client-cli) ### Comparing sentiments across different twitter accounts ``` $ llm compare 20 latest tweet directed @IndiHomeCare, @di_cbn, @BiznetHome, @ID_MyRepublic. What are people sentiment to the product? Do 1 search for each account I'll help you analyze the latest tweets for these internet service providers in Indonesia to understand the public sentiment. I'll use the search_twitter function for each account. Tool Calls: search_twitter Args: query: to:IndiHomeCare count: 20 sort_by: Latest Tool Calls: search_twitter Args: query: to:di_cbn count: 20 sort_by: Latest Tool Calls: search_twitter Args: query: to:BiznetHome count: 20 sort_by: Latest Tool Calls: search_twitter Args: query: to:ID_MyRepublic count: 20 sort_by: Latest Sentiment Analysis Summary: 1. IndiHomeCare: - Predominantly Negative Sentiment - Key Issues: - Unstable internet connection - Slow response times - Intermittent service disruptions - Long waiting times for customer support - Specific Complaints: - Network instability - Lagging internet - Unresolved technical issues - Lack of timely communication 2. CBN (di_cbn): - Mostly Negative Sentiment - Key Issues: - Prolonged internet outages (some reporting 1-2 days of no service) - Slow customer support response - Lack of clear communication about service disruptions - Specific Complaints: - LOS (Line of Sight) issues - No timely resolution of technical problems - Delayed email and support responses 3. BiznetHome: - Strongly Negative Sentiment - Key Issues: - Frequent network interruptions - Slow internet speeds - Poor customer support responsiveness - Specific Complaints: - Packet loss - Inconsistent connection - Long download times - Unresolved technical issues 4. MyRepublic (ID_MyRepublic): - Extremely Negative Sentiment - Key Issues: - Severe and prolonged service disruptions - Complete internet outages - Inability to access online services and games - Extremely poor customer support - Specific Complaints: - Multi-day service interruptions - Inability to access websites and online games - Missed technician appointments - Lack of compensation or clear communication Overall Sentiment Ranking (from Bad to Worst): 1. IndiHomeCare (Bad) 2. CBN (Worse) 3. BiznetHome (Very Bad) 4. MyRepublic (Extremely Bad) Common Themes Across Providers: - Poor network stability - Slow customer support response - Lack of transparent communication - Prolonged service interruptions - Unresolved technical issues
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.