logbook-mcp

logbook-mcp

Project memory across sessions for AI agents. A queryable decision log that lives in the repository, so an agent remembers what was decided and why, instead of re-deriving it at full token cost.

Built as an MCP server, so it works in any platform that speaks Model Context Protocol.

Why

Agents forget everything between sessions. The decision that "the domain is served by Cloudflare Pages, never deploy to Netlify" is paid for once and lost. Logbook persists it in .logbook/logbook.json, tagged and searchable, so the next session starts where the last one finished.

Tools

• logbook.record record a decision, finding, gotcha, or note with a scope and tags
• logbook.search search by text, scope, tags, or type
• logbook.recent the latest entries
• logbook.stats counts by type and scope
• logbook.forget remove an entry by id

Usage

npm install -g logbook-mcp

{
  "mcpServers": {
    "logbook": {
      "command": "logbook-mcp",
      "args": []
    }
  }
}

License

MIT. Part of the Tawakkul Labs MCP family.