🐦 Twitter Bookmarks MCP Server

This server syncs your Twitter/X bookmarks and exposes them via the Model Context Protocol (MCP).

Quick Start

  1. Click here to authenticate with Twitter
  2. After auth, use the MCP tools or call the API with your key to sync bookmarks
  3. Use the MCP endpoint at /mcp with your LLM client

API Endpoints

GET /auth - Start OAuth flow
GET /callback - OAuth callback (handled automatically)
GET /api/sync?period=week - Sync bookmarks (period: week/month/all)
GET /api/bookmarks?limit=50&offset=0 - List bookmarks
GET /api/bookmarks/:id - Get single bookmark
GET /api/search?q=query - Search bookmarks
GET /api/status - Check authentication & sync status
POST /mcp - MCP protocol endpoint

MCP Usage

Configure your LLM client (Claude Desktop, etc.) to use this MCP server:

{
  "mcpServers": {
    "twitter-bookmarks": {
      "url": "https://bookmarksmcp.com/mcp"
    }
  }
}

Available MCP Tools