Twikit

by adhikasp

149 401 downloads Not rated yet MIT
GitHub

About

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

Details

Repository
adhikasp/mcp-twikit
License
MIT

Explore

- 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

    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": "[email protected]",
            "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": "[email protected]",
                "TWITTER_PASSWORD": "secret",
                "TWITTER_USERNAME": "@example"
            },
            "args": [
                "--from",
                "git+https://github.com/adhikasp/mcp-twikit",
                "mcp-twikit"
            ],
            "command": "uvx"
        }
    }
}

Linux

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

Macos

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

Windows

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

MCP-Twikit

smithery badge
A Model Context Protocol (MCP) server for interacting with Twitter.

<a href="https://glama.ai/mcp/servers/49i9dd08w8">mcp-twikit MCP server</a>

Installation

Installing via Smithery

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

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

Manual Installation

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

Example usage

Using 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.

Videos about Twikit

Relevant YouTube tutorials, setups, and demos