Logbook MCP server

by cocaxcode·io.github.cocaxcode/logbook-mcp·v0.8.11·1 stars

No reviews yet

Developer logbook MCP server. Notes, TODOs, standups, decisions, debug sessions, reminders.

B78/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B78/100

full report

Adoption

New

1 stars58 downloads/wk

Reviews

Write one

Nobody has reviewed Logbook yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Logbook tools (10)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

logbook_entry
Gestiona entradas estructuradas del logbook. Acciones disponibles: - list: Lista entradas por tipo (note, decision, debug, standup, review). - edit: Edita contenido o topic de una entrada por ID. - delete: Elimina una entrada por ID y tipo. - standup: Registra standup diario (yesterday, today, blockers). - decision: Registra decision arquitectonica ADR (title, context, options, decision, consequen
logbook_inbox
Bandeja de entrada para notas r\xE1pidas. list: ver pendientes, process: mover a proyecto con frontmatter.
logbook_note
A\xF1ade una nota al logbook. Topics: feature, fix, chore, idea, decision, blocker. Si no se pasa topic, queda sin categorizar.
logbook_query
Busca y consulta el logbook. Acciones disponibles: - search: Busqueda full-text en notas y TODOs (FTS5). Requiere "query". - log: Actividad (notas + TODOs completados) para un periodo. Default: hoy. - timeline: Timeline cross-project/workspace. Default: semana.
logbook_reminders
Muestra recordatorios pendientes. scope: project (actual), workspace (todos los proyectos del workspace), global (todo).
logbook_review
Genera una nota de review semanal o mensual con resumen de actividad, estad\xEDsticas y highlights.
logbook_setup
Administracion del logbook. Acciones disponibles: - init: Inicializa vault Obsidian (dashboard, templates, inbox). - migrate: Migra datos de SQLite a Obsidian manualmente. Requiere modo obsidian. - status: Muestra modo actual, config, estado de migracion.
logbook_tags
Lista todos los tags usados en el logbook con su conteo. Opcionalmente filtra por un tag especifico.
logbook_todo
Gestiona TODOs del logbook. Acciones disponibles: - add: Crea uno (content) o varios (items). Soporta prioridades y recordatorios. - list: Lista TODOs agrupados por topic. Incluye manuales y del codigo (TODO/FIXME/HACK/BUG). - done: Marca como hecho (o undo). Recordatorios recurrentes se ack por hoy. - edit: Edita contenido, topic o prioridad de un TODO. - rm: Elimina TODOs por ID.
logbook_topics
Lista o crea temas para organizar notas y TODOs. Temas predefinidos: feature, fix, chore, idea, decision, blocker. Los custom pueden tener tipo (note o todo) y carpeta propia en Obsidian.

Public scan report

scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan9 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 144 days ago8/15
Maintainer identityregistry namespace matches repository owner6/10

Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Logbook compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 78/100; higher than 57% of 48,273 servers
Tools: 10; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 1; more than 65% of 28,534 servers
Downloads a week: 58; more than 49% of 11,915 servers with a package

What its tools let an agent do: 10 read

Install Logbook in Claude Code, Cursor or VS Code

Runs npx -y @cocaxcode/logbook-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add logbook-mcp -- npx -y @cocaxcode/logbook-mcp

Add to Cursor

What the publisher says

From the Logbook repository's README, as published. We do not edit it. Read it on GitHub

@cocaxcode/logbook-mcp Your developer logbook, always one sentence away. Notes · TODOs · Reminders · Code scanning · Full-text search · Native CLI · Obsidian-only

⚠️ v2.0 breaking change: SQLite eliminado. v2 sólo soporta backend Obsidian. Datos en ~/.logbook/logbook.db (v1) no se migran automáticamente — quedan intactos en disco. Si necesitas acceso a ellos, mantente en @cocaxcode/logbook-mcp@0.4. Tools 10→5 (con shims deprecated). Ver CHANGELOG.md para detalles.

Overview · Usage · Installation · Features · Tool Reference · Storage · Architecture

Quick Overview

logbook-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.

It 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.

Two 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.

Just Talk to It

No commands to memorize. Just say what you need.

Capture notes

"I decided to use JWT instead of sessions for scalability"
→ Saved as a decision — retrievable months from now

"The CI is failing due to a timeout in integration tests"
→ Captured as a blocker — shows up when you review activity

Track TODOs

"TODO: implement email validation"
→ Created with auto-inferred topic

"Add these: fix token refresh. update deps. add rate limiting"
→ 3 TODOs created at once, each categorized

"Mark 5 and 8 as done"
→ Both completed

"What's pending across all projects?"
→ Global view of everything, including code TODOs

Set reminders

"Remind me tomorrow to deploy"
→ One-time reminder

"Remind me every Tuesday to review PRs"
→ Recurring weekly — auto-acknowledged after each session

"Remind me on weekdays to check the CI"
→ Monday to Friday

Search anything

"Why did we choose JWT?"
→ Finds the decision note, even months later

"Search everything about auth"
→ FTS5 search across all notes and TODOs

Installation

Claude Code (recommended)

claude mcp add --scope user logbook -- npx -y @cocaxcode/logbook-mcp@latest --mcp

With Obsidian mode:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Logbook: common questions

Is Logbook MCP server safe?: Mostly: it is graded B (78/100). Read the Logbook safety report
How do I install Logbook?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Logbook need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Logbook maintained?: The last commit was 180 days ago (2026-05-06). The latest release is v0.8.11.
How does Logbook compare with other MCP servers?: safety score 78/100 (higher than 57% of 48,273 servers); tools 10 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.