Twitter MCP

What is twitter-mcp

twitter-mcp is a server developed by EnesCinr that integrates with Twitter to provide seamless interaction capabilities for AI systems, such as posting tweets and searching for relevant content on Twitter. This server operates using the Model Context Protocol (MCP), which is an open-source protocol by Anthropic. MCP allows AI systems to securely and efficiently connect with various data sources, tools, and prompts, providing a universal standard for accessing external data.

How to Use twitter-mcp

To begin using twitter-mcp, you need to set up your environment to connect to the Twitter API. Here’s a step-by-step guide:

1. Create a Twitter Developer Account: Sign up for a Twitter Developer account to obtain your API keys.

2. Configure Claude Desktop: Update your Claude Desktop configuration file with the necessary credentials:

   • For Windows: Edit the file located at %APPDATA%\Claude\claude_desktop_config.json.
   • For macOS: Edit the file located at ~/Library/Application Support/Claude/claude_desktop_config.json.

   Add the following configuration:

   {
     "mcpServers": {
       "twitter-mcp": {
         "command": "npx",
         "args": ["-y", "@enescinar/twitter-mcp"],
         "env": {
           "API_KEY": "your_api_key_here",
           "API_SECRET_KEY": "your_api_secret_key_here",
           "ACCESS_TOKEN": "your_access_token_here",
           "ACCESS_TOKEN_SECRET": "your_access_token_secret_here"
         }
       }
     }
   }
   

3. Restart Claude Desktop: After saving the changes, restart Claude Desktop to enable Twitter interactions.

Once configured, you can interact with Twitter through two main tools provided by twitter-mcp:

• post_tweet: Allows you to post new tweets directly.
• search_tweets: Enables you to search for tweets based on keywords or topics.

Key Features of twitter-mcp

• Twitter Integration: Effortlessly connect with Twitter to post tweets and search for content, expanding the capabilities of AI systems.

• Secure and Efficient: Utilizes the MCP protocol to ensure secure and standardized connections between AI clients and external services.

• Easy Configuration: Simple setup process with clear configuration steps for both Windows and macOS users.

• Troubleshooting Support: Access logs to troubleshoot any issues that may arise during operation:

  • Windows: Logs are located at %APPDATA%\Claude\logs\mcp-server-twitter.log.
  • macOS: Logs are located at ~/Library/Logs/Claude/mcp-server-twitter.log.

• Open Source Contribution: Users can contribute to the development or run the server from source by cloning the repository, installing dependencies, and building the project.

• MIT Licensed: The server is open-source and available under the MIT license, encouraging transparency and community involvement.

twitter-mcp is a robust tool for anyone looking to leverage AI to interact with Twitter, providing a seamless bridge between AI systems and the social media platform. Whether for personal use or integration into larger AI projects, twitter-mcp offers a straightforward and secure solution for accessing Twitter’s vast data in real-time.