![\"npm](\"https://img.shields.io/npm/v/@cocaxcode/logbook-mcp.svg?style=flat-square&color=cb3837\")
\n ![\"npm](\"https://img.shields.io/npm/dm/@cocaxcode/logbook-mcp.svg?style=flat-square\")
\n ![\"License\"](\"https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square\"){kind=icon}
\n ![\"Node\"](\"https://img.shields.io/badge/node-%3E%3D20-339933?style=flat-square&logo=node.js&logoColor=white\"){kind=icon}
\n ![\"5](\"https://img.shields.io/badge/tools-5%20%2B%205%20deprecated-blueviolet?style=flat-square\"){kind=icon}
\n\n
\n Your developer logbook, always one sentence away.
\n Notes · TODOs · Reminders · Code scanning · Full-text search · Native CLI · Obsidian-only\n
\n \n \n \n
\n Overview ·\n Usage ·\n Installation ·\n Features ·\n Tool Reference ·\n Storage ·\n Architecture\n
\n\n---\n\n## Quick Overview\n\nlogbook-mcp is an MCP server that turns your AI assistant into a persistent developer logbook. Capture decisions, track TODOs, set reminders, scan code TODOs, and search everything with full-text search — without leaving your editor.\n\nIt auto-detects your git project, stores everything locally, and works with any MCP-compatible client: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex CLI, or Gemini CLI. **All data stays on your machine — nothing is synced, nothing is tracked, nothing leaves your disk.** Notes are scoped per-project automatically, but you can search globally across all your projects at any time.\n\nTwo storage modes: **SQLite** (default, zero config) or **Obsidian** (markdown files with frontmatter, visible in your Obsidian vault with Graph View, Dataview, Tasks, and Calendar). Switching from SQLite to Obsidian **auto-migrates your data** on startup.\n\n---\n\n## Just Talk to It\n\nNo commands to memorize. Just say what you need.\n\n### Capture notes\n\n```\n\"I decided to use JWT instead of sessions for scalability\"\n→ Saved as a decision — retrievable months from now\n\n\"The CI is failing due to a timeout in integration tests\"\n→ Captured as a blocker — shows up when you review activity\n```\n\n### Track TODOs\n\n```\n\"TODO: implement email validation\"\n→ Created with auto-inferred topic\n\n\"Add these: fix token refresh. update deps. add rate limiting\"\n→ 3 TODOs created at once, each categorized\n\n\"Mark 5 and 8 as done\"\n→ Both completed\n\n\"What's pending across all projects?\"\n→ Global view of everything, including code TODOs\n```\n\n### Set reminders\n\n```\n\"Remind me tomorrow to deploy\"\n→ One-time reminder\n\n\"Remind me every Tuesday to review PRs\"\n→ Recurring weekly — auto-acknowledged after each session\n\n\"Remind me on weekdays to check the CI\"\n→ Monday to Friday\n```\n\n### Search anything\n\n```\n\"Why did we choose JWT?\"\n→ Finds the decision note, even months later\n\n\"Search everything about auth\"\n→ FTS5 search across all notes and TODOs\n```\n\n---\n\n## Installation\n\n### Claude Code (recommended)\n\n```bash\nclaude mcp add --scope user logbook -- npx -y @cocaxcode/logbook-mcp@latest --mcp\n```\n\nWith Obsidian mode:\n\n```bash\nclaude mcp add --scope user logbook -- npx -y @cocaxcode/logbook-mcp@latest --mcp --storage obsidian --dir \"/path/to/vault/logbook\"\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"logbook-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cocaxcode/logbook-mcp@latest\", \"--mcp\"]\n }\n }\n}\n```\n\nWith Obsidian mode:\n\n```json\n{\n \"mcpServers\": {\n \"logbook-mcp\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\", \"@cocaxcode/logbook-mcp@latest\", \"--mcp\",\n \"--storage\", \"obsidian\",\n \"--dir\", \"/path/to/vault/logbook\"\n ]\n }\n }\n}\n```\n\nlogbook_note — Add a notelogbook_todo — Full TODO managementlogbook_entry — Structured entrieslogbook_query — Search and activitylogbook_setup — Admin tools