# Lanternote

> Lanternote is an open-source MCP server for knowledge and memory. Search, read and query very large folders of Markdown notes, with reversible edits. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux
- **Website:** https://ericthai-labs.github.io/lanternote/
- **Repository:** https://github.com/ericthai-labs/lanternote
- **MCP Registry name:** io.github.ericthai-labs/lanternote
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-14

## About

Lanternote is a desktop notes app first, and its MCP server is one part of it. The app is described as tested on a real library of about 190,000 notes and 2.49 million links, with full-text search in tens of milliseconds and a live query over the whole library in roughly a tenth of a second.

An assistant such as Claude Code or Claude Desktop can search, read, run queries and list tasks. Creating notes, editing passages and ticking tasks are possible only if you allow them, every AI change keeps the previous text and is logged, and the assistant can be limited to chosen folders. Claude Desktop installs from a .mcpb file and starts read-only.

Notes stay as ordinary Markdown files in a folder you choose, with nothing uploaded and no account. The app adds a link graph, Kanban boards, canvases and a Command Center page, and is open source under Apache 2.0.

## Features

- **Large-vault search:** Full-text search across hundreds of thousands of notes.
- **Live queries:** Tables, lists, tasks and calendars from dataview blocks.
- **Opt-in editing:** Writes only when allowed, keeping prior text and a log.
- **Folder limits:** Restricts the assistant to chosen folders.
- **Plain Markdown files:** Notes stay readable in any text editor.

## Good for

- Ask an assistant to find a note in a huge library
- List open tasks across a notes folder
- Draft or edit a note with changes you can undo
- Run a query over notes without opening the app

## Install

### Claude Code (Terminal)

```sh
claude mcp add lanternote -- npx -y https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "lanternote": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "lanternote": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "lanternote": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "lanternote": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "lanternote": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb"
      ]
    }
  }
}
```

## FAQ

### Is editing on by default?

No. The Claude Desktop bundle is read-only until you allow editing.

### What happens to changed text?

Every AI change keeps the previous text and is logged.

### Does it need an account?

No account or cloud; everything works offline.

### What is the licence?

Apache License 2.0.

### Is Lanternote free?

Yes. Lanternote is open source, so you can use and self-host it for free.

### How do I add Lanternote to Claude Code?

Run this command in your terminal: claude mcp add lanternote -- npx -y https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb

### What are the best alternatives to Lanternote?

The closest alternatives to Lanternote are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/lanternote
