tweetsmash-mcp MCP Server

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…

Local serverstdio

What is the tweetsmash-mcp Server?

tweetsmash-mcp is an MCP project maintained in the ramyachinnadurai/tweetsmash-mcp repository. The maintainer describes its purpose as “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…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @tweetsmash/mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares TWEETSMASH_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_bookmarksPage through saved posts with filters
search_bookmarksKeyword and semantic search across every bookmark
get_bookmark_countCount bookmarks, optionally by label
list_labelsList every label in your library
add_labels_to_tweetsLabel bookmarks from your agent
remove_labels_from_tweetsRemove labels
setup_vector_storeBuild the semantic search index

How to install the tweetsmash-mcp Server

{
  "mcpServers": {
    "tweetsmash": {
      "command": "npx",
      "args": [
        "@tweetsmash/mcp"
      ],
      "env": {
        "TWEETSMASH_TOKEN": "YOUR_TWEETSMASH_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
TWEETSMASH_TOKENDeclared in the maintainer’s client configuration.Check documentation