steipete/birdclaw

Stores all your tweets nicely claw-able for agents.

What it solves

Birdclaw provides a local-first, searchable archive of your Twitter/X history. It allows users to maintain their own copy of tweets, DMs, and follow graphs without relying on a cloud backend, ensuring long-term access to their digital history.

How it works

The tool imports data from Twitter/X archives (ZIP files) into a local SQLite database. It uses FTS5 for fast local search of tweets and DMs. To keep data current, it can optionally sync live data via xurl or a private bird installation. The system exposes this data through three interfaces: a web application, a command-line interface (CLI), and an optional read-only Model Context Protocol (MCP) server for AI agents.

Who it’s for

Users who want full ownership and local control over their Twitter/X data, researchers who need a searchable local database of their social media history, and developers who want to provide AI agents with read-only access to their cached tweet history.

Highlights

  • Local-first storage using SQLite for privacy and offline access.
  • Idempotent archive imports for tweets, DMs, likes, bookmarks, and profiles.
  • Integrated web app and CLI for browsing and searching history.
  • Read-only MCP server to expose cached tweet search and thread tools to LLMs.
  • Deterministic JSONL shards for Git-friendly backups.

Related

  • Project
    ythx-101/x-tweet-fetcher

    A tool for fetching X/Twitter tweets, timelines, and articles without API keys or logins, featuring automatic backend fallback and a unified JSON schema for AI agents.

  • Project
    6551Team/opentwitter-mcp

    opentwitter‑mcp is a Python MCP server that lets AI assistants fetch Twitter/X profiles, tweets, searches and real‑time follower events via a set of ready‑made tools and a WebSocket push API.

  • Project
    goniszewski/grimoire

    A local-first, private bookmark manager for technical resources that uses AI to summarize, tag, and provide semantic search over saved web content.

  • Project
    afar1/fieldtheory-cli

    A command-line tool that syncs X bookmarks to a local knowledge base, enabling LLM-powered classification and providing AI agents with grounded local context.

  • Project
    kenn-io/msgvault

    A local-first, open-source archive for emails, chats, and contacts that consolidates communication history into a user-owned system of record with AI-enhanced search capabilities.