Skip to content
MCP server

Lanternote

Search, read and query very large folders of Markdown notes, with reversible edits

Runs locallyStatus and history
Pricing
Open source
Platforms
Windows, macOS, Linux
Runs
Locally
Version
1.25.1
Listing updated
3 days ago

About Lanternote

Lanternote is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "lanternote": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lanternote": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ericthai-labs/lanternote/releases/download/v1.25.1/lanternote-1.25.1.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Free for personal use; Apache 2.0

Prices change. Check ericthai-labs.github.io before you buy.

Lanternote 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 to Lanternote

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools