X (Twitter)

What is twitter-mcp?

twitter-mcp is a Model Context Protocol (MCP) server designed to facilitate interaction with the Twitter API. It allows clients, such as AI models, to perform actions like posting tweets and searching for tweets by query.

How to use twitter-mcp?

To use twitter-mcp, you need a Twitter Developer account and API keys. Once you have these, you configure your Claude Desktop (or similar MCP-compatible application) by adding the twitter-mcp configuration to its settings file. This involves specifying the command to run the server and providing your Twitter API credentials as environment variables. After restarting Claude Desktop, the post_tweet and search_tweets tools become available.

Key Features of twitter-mcp

• Tweet Posting: Allows programmatic posting of new tweets.
• Tweet Searching: Enables searching for tweets based on a given query.
• MCP Server: Integrates as an MCP server, making it accessible to MCP-compatible clients like Claude Desktop.
• Easy Configuration: Simple setup by adding a JSON configuration to your application's settings.

Use Cases of twitter-mcp

• Automated Social Media Management: AI models can automatically post updates or respond to events on Twitter.
• Content Curation: AI can search for relevant tweets based on keywords for content aggregation or analysis.
• Customer Service Bots: Develop bots that can search for mentions or post replies on Twitter.
• Research and Data Collection: Programmatically collect Twitter data for research purposes.

FAQ from twitter-mcp

Q: How do I get my Twitter API keys? A: You can obtain your API keys from the Twitter Developer Portal after creating a developer account.

Q: Where can I find logs for troubleshooting? A: Logs are located at %APPDATA%\Claude\logs\mcp-server-twitter.log on Windows and ~/Library/Logs/Claude/mcp-server-twitter.log on macOS.

Q: Can I contribute to twitter-mcp? A: Yes, you can contribute by cloning the repository, installing dependencies, building the project, and running it locally. The project is open source under the MIT License.

Twitter MCP Server

This MCP server allows Clients to interact with Twitter, enabling posting tweets and searching Twitter.

Quick Start

1. Create a Twitter Developer account and get your API keys from Twitter Developer Portal

2. Add this configuration to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

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

That's it! Claude can now interact with Twitter through two tools:

• post_tweet: Post a new tweet
• search_tweets: Search for tweets

Example Usage

Try asking Claude:

• "Can you post a tweet saying 'Hello from Claude!'"
• "Can you search for tweets about Claude AI?"

Troubleshooting

Logs can be found at:

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

Development

If you want to contribute or run from source:

1. Clone the repository:

git clone https://github.com/EnesCinr/twitter-mcp.git
cd twitter-mcp

2. Install dependencies:

npm install

3. Build:

npm run build

4. Run:

npm start

Running evals

The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

License

MIT