🐦 Twitter Bookmarks MCP Server

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

This is a private, single-account server. The OAuth connect flow is restricted to the owner and requires a secret key.

Quick Start

  1. Connect via /auth?key=<secret> (owner only)
  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