Skip to main content
MCP server CX Codex

Lumber — Claude Code MCP server: features and setup

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

MIT updated 2026-11-15

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add lumber -- npx -y @infinitetoken/lumber-cli
Open on GitHub

What Lumber 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.

What it helps with

  • 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 for the agent

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

How to install Lumber

Platform CLI

claude mcp add lumber -- npx -y @infinitetoken/lumber-cli

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Lumber

How do I install Lumber in Claude Code?

Run claude mcp add lumber -- npx -y @infinitetoken/lumber-cli. Then sign in with lumber login so the server can use the saved session.

What does Lumber do?

It gives an agent MCP tools to browse Lumber apps, search logs, read notes, and wait for new entries. Logs are decrypted on the local computer, and the server cannot modify them.

What does Lumber need to run?

You need a Lumber account and its key on an already linked device with an up-to-date Lumber app. Linux also needs a running Secret Service, such as GNOME Keyring or KWallet.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open