twitter mcp

Local 2025-08-31 23:30:58 0

An MCP server that enables Claude to interact with Twitter, allowing for posting tweets and searching Twitter content.

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

Quick Start

Create a Twitter Developer account and get your API keys from Twitter Developer Portal
Add this configuration to your Claude Desktop config file:

Windows: %APPDATA%Claudeclaude_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"
      }
    }
  }
}

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%Claudelogsmcp-server-twitter.log - macOS: ~/Library/Logs/Claude/mcp-server-twitter.log

Development

If you want to contribute or run from source:

Clone the repository:

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

Install dependencies:
```
npm install
```
Build:
```
npm run build
```
Run:
```
npm start
```

License

MIT

[
  {
    "description": "Post a new tweet to Twitter",
    "inputSchema": {
      "properties": {
        "text": {
          "description": "The content of your tweet",
          "maxLength": 280,
          "type": "string"
        }
      },
      "required": [
        "text"
      ],
      "type": "object"
    },
    "name": "post_tweet"
  },
  {
    "description": "Search for tweets on Twitter",
    "inputSchema": {
      "properties": {
        "count": {
          "description": "Number of tweets to return (10-100)",
          "maximum": 100,
          "minimum": 10,
          "type": "number"
        },
        "query": {
          "description": "Search query",
          "type": "string"
        }
      },
      "required": [
        "query",
        "count"
      ],
      "type": "object"
    },
    "name": "search_tweets"
  }
]