# 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](https://www.tweetsmash.com) 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](https://www.tweetsmash.com/x-bookmarks-api).

## Quick start

1. Create a Tweetsmash account at [tweetsmash.com](https://www.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:

```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:

```
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](https://www.tweetsmash.com/x-bookmarks-mcp)
- [Setup guide: Claude Desktop, Raycast, Smithery](https://www.tweetsmash.com/api-docs/mcp-integration)
- [X Bookmarks API](https://www.tweetsmash.com/x-bookmarks-api)
- [npm: @tweetsmash/mcp](https://www.npmjs.com/package/@tweetsmash/mcp)
- [Smithery listing](https://smithery.ai/server/@RamyaChinnadurai/tweetsmash)

## License

MIT