# logbook MCP server

> Turns your AI assistant into a persistent developer logbook for capturing decisions, tracking TODOs, and setting reminders.

- Repository: https://github.com/cocaxcode/logbook-mcp
- Page: https://hostedmcp.org/servers/cocaxcode/logbook-mcp
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.8.11

## Install

### Claude Code

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

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "logbook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cocaxcode/logbook-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "logbook-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cocaxcode/logbook-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"logbook-mcp","type":"stdio","command":"npx","args":["-y","@cocaxcode/logbook-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "logbook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cocaxcode/logbook-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add logbook-mcp -- npx -y @cocaxcode/logbook-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.logbook-mcp]
command = "npx"
args = ["-y", "@cocaxcode/logbook-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user logbook-mcp npx -- -y @cocaxcode/logbook-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "logbook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@cocaxcode/logbook-mcp"
      ]
    }
  }
}
```

## Tools (39)

- `logbook_note`
- `logbook_todo`
- `logbook_entry`
- `logbook_query`
- `logbook_topics`
- `logbook_tags`
- `logbook_reminders`
- `logbook_review`
- `logbook_inbox`
- `logbook_setup`
- `content`
- `topic`
- `items`
- `priority`
- `remind_at`
- `remind_pattern`
- `status`
- `source`
- `scope`
- `ids`
- `undo`
- `yesterday`
- `today`
- `blockers`
- `title`
- `context`
- `options`
- `decision`
- `consequences`
- `error`
- `cause`
- `fix`
- `file`
- `type`
- `limit`
- `query`
- `period`
- `workspace`
- `force`

## FAQ

### Does my data leave my machine?

No, all data stays on your machine and nothing is synced or tracked outside your disk.

### Can I use this with Obsidian?

Yes, it supports an Obsidian storage mode where notes are saved as markdown files with frontmatter, making them visible in your Obsidian vault.

### Can I migrate my data from SQLite to Obsidian?

Yes, if you switch to Obsidian mode and autoMigrate is set to true, your existing SQLite data is automatically migrated on startup.