https://github.com/EnesCinr/twitter-mcp
A Model Context Protocol server allows to interact with Twitter, enabling posting tweets and searching Twitter.
https://github.com/EnesCinr/twitter-mcp
Last synced: 7 months ago
JSON representation
A Model Context Protocol server allows to interact with Twitter, enabling posting tweets and searching Twitter.
- Host: GitHub
- URL: https://github.com/EnesCinr/twitter-mcp
- Owner: EnesCinr
- License: mit
- Created: 2024-12-11T02:42:14.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-12T12:53:13.000Z (8 months ago)
- Last Synced: 2025-03-12T13:37:18.643Z (8 months ago)
- Language: TypeScript
- Size: 16.6 KB
- Stars: 110
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **twitter-mcp** - A Model Context Protocol server allows to interact with Twitter, enabling posting tweets and searching Twitter. `typescript` `server` `api` `http` `git` `npm install EnesCinr/twitter-mcp` (🌐 Web Development)
- metorial-index - Twitter Server - Interact with Twitter to post tweets and perform searches on the platform. (Social Media)
- awesome-mcp-servers - X (Twitter) - A Model Context Protocol server allows to interact with Twitter, enabling posting tweets and searching Twitter. (Table of Contents / Social Media)
README
# Twitter MCP Server
[](https://smithery.ai/server/@enescinar/twitter-mcp)
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](https://developer.twitter.com/en/portal/dashboard)
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`
```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:
```bash
git clone https://github.com/EnesCinr/twitter-mcp.git
cd twitter-mcp
```
2. Install dependencies:
```bash
npm install
```
3. Build:
```bash
npm run build
```
4. Run:
```bash
npm start
```
## License
MIT