English Français العربية

com.tweetsmash/mcp

Official registry Search and web

Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http com-tweetsmash-mcp 'https://mcp.tweetsmash.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "com-tweetsmash-mcp": {
            "type": "http",
            "url": "https://mcp.tweetsmash.com/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Tweetsmash MCP Server: X (Twitter) Bookmarks for AI Agents
  2. Quick start
  3. Tools
  4. Example prompts
  5. Links
  6. License

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

  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

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

Example prompts

  • "Find my bookmarks about prompt engineering"
  • "How many bookmarks mention MCP?"
  • "Label everything I saved last week as AI"

License

MIT

Frequently asked questions

What is com.tweetsmash/mcp?

Search, label, and manage your X (Twitter) bookmarks from any MCP client via Tweetsmash

How do I install com.tweetsmash/mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http com-tweetsmash-mcp 'https://mcp.tweetsmash.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.tweetsmash/mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is com.tweetsmash/mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains com.tweetsmash/mcp?

It is published by RamyaChinnadurai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.