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:

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:

Code

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"

License

MIT

Tweetsmash MCP README