battermanz/hatchdoor repository overview

⁠Hatchdoor

Self-hosted, agent-native web app and MCP server for your Obsidian-style Markdown vault. Browse, search, and edit your notes in a fast web UI, and give AI agents first-class access to the same vault over the Model Context Protocol (MCP).

Point an MCP client (Claude, Claude Code, Codex, Cursor, Hermes, …) at Hatchdoor and your agent can read, search (keyword and semantic), create, edit, move, and link notes — through the same safe, atomic vault operations the UI uses, with optional automatic git commit-and-push. Your Markdown files stay the source of truth; Hatchdoor builds a disposable SQLite read model it can rebuild from the vault at any time.

The runtime image is distroless and rootless — built on gcr.io/distroless/cc-debian13:nonroot, it ships no shell or package manager and runs as an unprivileged nonroot user. It runs unchanged under Docker or Podman.

• Source & full README: https://github.com/BattermanZ/Hatchdoor⁠
• Live demo: https://hatchdoor.battercloud.cc⁠

⁠Tags

• latest, <version> (e.g. 2.2.0) — Docker / OCI images
• podman-latest, podman-<version> — images published for Podman users

⁠Quick start

services:
  hatchdoor:
    image: battermanz/hatchdoor:latest
    container_name: hatchdoor
    environment:
      HOST: 0.0.0.0
      HATCHDOOR_WEB_BEARER_TOKEN: change-me
    ports:
      - "42824:42824"
    volumes:
      - ./vault:/data/vault
      - ./data/cache:/data/cache
    restart: unless-stopped

Then open http://localhost:42824⁠. See the GitHub README⁠ for MCP client setup, configuration, and all environment variables.

⁠License

AGPL-3.0-only