Tweetsmash MCP Server: X (Twitter) Bookmarks for AI Agents (com.tweetsmash/mcp)

The com.tweetsmash/mcp Model Context Protocol (MCP) server connects Tweetsmash to X (Twitter) bookmarks so they can be accessed from any MCP client. It enables semantic search over imported bookmarks, counts bookmarks, and manages labels using natural language.

🛠️ Key Features

Search X (Twitter) bookmarks semantically
Count bookmarks
Manage labels through natural language
Expose bookmarks to MCP clients

🚀 Use Cases

Use AI agents in Claude, ChatGPT, Cursor, and Raycast to work with X bookmarks
Build workflows that reference a searchable library of bookmarked X posts
Use Tweetsmash’s label management for organization

⚡ Developer Benefits

Integrates with MCP-compatible clients via Model Context Protocol
Supports developers working with AI agents over external bookmark data
Complements the X bookmarks API from Tweetsmash

⚠️ Limitations

Functionality is scoped to X (Twitter) bookmarks via Tweetsmash
Labeled management and search are described as operating through natural language

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:

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

is_unread_only	boolean	optional	Filter to only unread bookmarks
hide_archived	boolean	optional	Hide archived bookmarks
media_type	string	optional	Filter by media type
author	string	optional	Filter by author username. Use this parameter when the user wants to find tweets by a specific author (e.g., 'Show tweets by @user'). Do NOT use 'q' for author names.
tag	string	optional	Filter by tag
posted_from	string	optional	Filter tweets posted after this date (ISO 8601 string)
posted_to	string	optional	Filter tweets posted before this date (ISO 8601 string)
bookmarked_from	string	optional	Filter bookmarks added after this date (ISO 8601 string)
bookmarked_to	string	optional	Filter bookmarks added before this date (ISO 8601 string)
limit	number	optional	Number of bookmarks to retrieve (1-100)
cursor	string	optional	Pagination cursor for next page
sort_by	string	optional	Sort order for results
sort_cursor	string	optional	Cursor for pagination when using sort_by (use value from meta.sort_cursor of previous response)

is_unread_only	boolean	optional	Filter to only unread bookmarks
hide_archived	boolean	optional	Hide archived bookmarks
media_type	string	optional	Filter by media type
author	string	optional	Filter by author username. Use this parameter when the user wants to find tweets by a specific author (e.g., 'Show tweets by @user'). Do NOT use 'q' for author names.
tag	string	optional	Filter by tag
posted_from	string	optional	Filter tweets posted after this date (ISO 8601 string)
posted_to	string	optional	Filter tweets posted before this date (ISO 8601 string)
bookmarked_from	string	optional	Filter bookmarks added after this date (ISO 8601 string)
bookmarked_to	string	optional	Filter bookmarks added before this date (ISO 8601 string)
q	string	optional	Keyword or text search query for finding bookmarks by exact words or phrases in tweet content. Do NOT use this for author names - use the 'author' parameter instead.
vector_search_term	string	optional	Semantic search query for retrieving bookmarks based on meaning and context, not just keywords. Use for natural language questions or topic-based searches.
limit	number	optional	Number of bookmarks to retrieve (1-100)
cursor	string	optional	Pagination cursor for next page
sort_by	string	optional	Sort order for results
sort_cursor	string	optional	Cursor for pagination when using sort_by (use value from meta.sort_cursor of previous response)

is_unread_only	boolean	optional	Filter to only unread bookmarks
hide_archived	boolean	optional	Hide archived bookmarks
media_type	string	optional	Filter by media type
author	string	optional	Filter by author username. Use this parameter when the user wants to find tweets by a specific author (e.g., 'Show tweets by @user'). Do NOT use 'q' for author names.
tag	string	optional	Filter by tag
posted_from	string	optional	Filter tweets posted after this date (ISO 8601 string)
posted_to	string	optional	Filter tweets posted before this date (ISO 8601 string)
bookmarked_from	string	optional	Filter bookmarks added after this date (ISO 8601 string)
bookmarked_to	string	optional	Filter bookmarks added before this date (ISO 8601 string)

tweet_ids	array	required	Array of tweet IDs to add the label to
label_id	string	optional	ID of existing label (use either label_id or label_name)
label_name	string	optional	Name of the label to create/add (use either label_id or label_name)

tweet_ids	array	required	Array of tweet IDs to remove label from
label_name	string	required	Name of the label to remove

com.tweetsmash/mcp