streamable-httpupdated 1mo ago
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.
What can you do with tweetsmash?
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 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.
Quick start
- Create a Tweetsmash account at tweetsmash.com and import your X bookmarks (one click).
- Generate an API token: Settings > Integrations > API.
- Add the server to your MCP config:
{
"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
- Setup guide: Claude Desktop, Raycast, Smithery
- X Bookmarks API
- npm: @tweetsmash/mcp
- Smithery listing
License
MIT
Install
Add tweetsmash to your client. Pick the one you use.
claude mcp add --transport http tweetsmash https://mcp.tweetsmash.com/api/mcpcodex mcp add tweetsmash --url https://mcp.tweetsmash.com/api/mcp{
"mcpServers": {
"tweetsmash": {
"url": "https://mcp.tweetsmash.com/api/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"tweetsmash": {
"type": "http",
"url": "https://mcp.tweetsmash.com/api/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"tweetsmash": {
"url": "https://mcp.tweetsmash.com/api/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"tweetsmash": {
"serverUrl": "https://mcp.tweetsmash.com/api/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
7 tools
tweetsmash exposes 7 tools to a connected agent.
- 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
Score
62 / 100
Good
- Documentation22/25
- Maintenance16/25
- Trust6/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 51 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 7 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 2.0.0Latest | Jul 11, 2026 |