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
claude mcp add lumber -- npx -y @infinitetoken/lumber-cliWhat 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-cliPlatform CLI
codex mcp add lumber -- npx -y @infinitetoken/lumber-cliConfig file
{
"mcpServers": {
"lumber": {
"command": "npx",
"args": [
"-y",
"@infinitetoken/lumber-cli"
]
}
}
}Config file
{
"servers": {
"lumber": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@infinitetoken/lumber-cli"
]
}
}
}Platform CLI
gemini mcp add lumber npx -y @infinitetoken/lumber-cliStep 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.