mcp

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

1. Create a Tweetsmash account at 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:

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