x-bookmarks-mcp

Fully local, privacy-first MCP server that turns your X (Twitter) bookmarks into a searchable, enriched knowledge base for Claude.

[](https://github.com/p0ki/x-bookmarks-mcp/actions/workflows/ci.yml) [](LICENSE)

• 100% offline — no X API keys, no third-party services, no telemetry
• Full-text search across tweet text, threads, linked page content, notes, and tags
• Auto-enrichment — fetches and extracts content from URLs in your bookmarks
• MCP integration — 8 tools available to Claude for searching, browsing, tagging, and summarizing

Use a browser extension like twitter-web-exporter to export your X bookmarks as JSON.

Save the export to data/exports/bookmarks.json.

git clone https://github.com/p0ki/x-bookmarks-mcp.git
cd x-bookmarks-mcp
pip install -r requirements.txt

python -m src import data/exports/bookmarks.json
python -m src enrich

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "xbookmarks": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/absolute/path/to/x-bookmarks-mcp"
    }
  }
}

Replace /absolute/path/to/x-bookmarks-mcp with the full path to your clone.

git clone https://github.com/p0ki/x-bookmarks-mcp.git
cd x-bookmarks-mcp
pip install -r requirements.txt

Requires Python 3.11 or higher. All dependencies are listed in requirements.txt.

# Import bookmarks from JSON export
python -m src import data/exports/bookmarks.json

# Fetch and extract content from URLs in book