Overview

MCP-Twikit is a Model Context Protocol server that enables AI assistants to interact with Twitter. It provides a set of tools for searching tweets, retrieving timeline data, and analyzing Twitter content, allowing AI models to access real-time social media information.

Installation Options

Using Smithery (Recommended)

The easiest way to install MCP-Twikit is through Smithery:

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

This command automatically installs and configures MCP-Twikit for use with Claude Desktop.

Manual Installation

For manual installation, you'll need to configure your MCP client with the following settings:

{
    "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"
        }
    }
}

Make sure to replace the placeholder credentials with your actual Twitter account information.

Available Tools

MCP-Twikit provides several tools for interacting with Twitter:

search_twitter

Search for tweets matching specific criteria.

Parameters:

• query: The search query (e.g., "to:IndiHomeCare")
• count: Number of tweets to retrieve (default: 20)
• sort_by: Sort order (e.g., "Latest")

get_timeline

Retrieve tweets from your home timeline.

Parameters:

• None (uses the authenticated account)

Example Use Cases

Analyzing Sentiment Across Twitter Accounts

You can use MCP-Twikit to compare sentiment across different Twitter accounts:

Compare the 20 latest tweets directed at @IndiHomeCare, @di_cbn, @BiznetHome, and @ID_MyRepublic. What is the customer sentiment toward each product?

Monitoring Your Twitter Timeline

Check what's happening on your Twitter timeline:

What is happening on my Twitter timeline?

Requirements

• Twitter account credentials
• An MCP-compatible client (such as Claude Desktop or mcp-client-cli)

Troubleshooting

If you encounter issues with authentication, ensure your Twitter credentials are correctly specified in the environment variables. For other problems, check the server logs for detailed error messages.

Privacy Considerations

Remember that MCP-Twikit will have access to your Twitter account. Use with trusted AI assistants and be mindful of the data you're sharing.