com.tweetsmash/mcp
Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash
Open source Repository Open in the app JSON README (API)
About
Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash
Details
- Kind
- MCP servers
- Topic
- Social & content
- Publisher
- com.tweetsmash
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 2.0.0
- Last push
- 2026-07-11T19:06:25Z
- Repository state
- ativo
- Added
- 2026-08-29 03:01:25
- Updated
- 2026-08-29 03:01:25
- Origin id
com.tweetsmash/mcp
README
# Tweetsmash MCP Server: X (Twitter) Bookmarks for AI Agents
The Tweetsmash MCP server connects Claude, ChatGPT, Cursor, Raycast, and any
Model Context Protocol client to your X (Twitter) bookmarks. Search them
semantically, count them, and manage labels through natural language.
[Tweetsmash](https://www.tweetsmash.com) is a bookmark manager for X (Twitter):
it imports the posts you bookmark on X into a searchable library, syncs them to
Notion, Google Sheets, and Zotero, and exposes them to AI agents through this
MCP server and an [X bookmarks API](https://www.tweetsmash.com/x-bookmarks-api).
## Quick start
1. Create a Tweetsmash account at [tweetsmash.com](https://www.tweetsmash.com) and
import your X bookmarks (one click).
2. Generate an API token: Settings > Integrations > API.
3. Add the server to your MCP config:
```json
{
"mcpServers": {
"tweetsmash": {
"command": "npx",
"args": ["@tweetsmash/mcp"],
"env": { "TWEETSMASH_TOKEN": "your-token-here" }
}
}
}
```
### Hosted endpoint (no local install)
Point any remote MCP client at:
```
https://mcp.tweetsmash.com/api/mcp
```
with your Tweetsmash API token as a Bearer header.
## Tools
| Tool | What it does |
|---|---|
| `list_bookmarks` | Page through saved posts with filters |
| `search_bookmarks` | Keyword and semantic search across every bookmark |
| `get_bookmark_count` | Count bookmarks, optionally by label |
| `list_labels` | List every label in your library |
| `add_labels_to_tweets` | Label bookmarks from your agent |
| `remove_labels_from_tweets` | Remove labels |
| `setup_vector_store` | Build the semantic search index |
## Example prompts
- "Find my bookmarks about prompt engineering"
- "How many bookmarks mention MCP?"
- "Label everything I saved last week as AI"
## Links
- [X Bookmarks MCP](https://www.tweetsmash.com/x-bookmarks-mcp)
- [Setup guide: Claude Desktop, Raycast, Smithery](https://www.tweetsmash.com/api-docs/mcp-integration)
- [X Bookmarks API](https://www.tweetsmash.com/x-bookmarks-api)
- [npm: @tweetsmash/mcp](https://www.npmjs.com/package/@tweetsmash/mcp)
- [Smithery listing](https://smithery.ai/server/@RamyaChinnadurai/tweetsmash)
## License
MIT