# Lumber

An MCP server for Claude Code gives an agent access to Lumber logs. Ask it to search entries or wait for incoming errors.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: infinitetoken
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/infinitetoken/Lumber-CLI
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/lumber

## What it does

Lumber exposes tools for browsing apps, searching their logs, and reading notes attached to log entries. An agent can filter by app, severity, time, or text, and wait for new errors. Decryption happens on your computer; the server only reads data.

Sign-in requires a Lumber account and its key on a device already linked to that account, running an up-to-date Lumber app. Run `lumber login` first, then add the MCP server with `claude mcp add lumber -- npx -y @infinitetoken/lumber-cli`. On Linux, the CLI stops if no Secret Service is running, such as GNOME Keyring or KWallet.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add lumber -- npx -y @infinitetoken/lumber-cli
```

### Codex

**Platform CLI**
```bash
codex mcp add lumber -- npx -y @infinitetoken/lumber-cli
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lumber": {
            "command": "npx",
            "args": [
                "-y",
                "@infinitetoken/lumber-cli"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "lumber": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@infinitetoken/lumber-cli"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add lumber npx -y @infinitetoken/lumber-cli
```

## When to use it
- search logs by app, severity, and time range
- find entries matching text in messages and metadata
- wait for incoming errors and return them to an agent
- list Lumber apps and notes attached to their logs

## Example prompts
- Search Lumber-Test logs for errors from the last two hours.
- Wait for new errors in Lumber-Test, then find their cause in this repository.
- List my Lumber apps and show their log notes.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
