Skip to main content

mnemo-brain-mcp

MCP (Model Context Protocol) bridge to query your Mnemo second brain from Claude Code, Cursor, Cline, Windsurf, and any MCP-compatible AI tool.

What is this?

This is a friendly fork of desimpkins/daniel-lightrag-mcp. The protocol logic is identical; the package is renamed for one reason: a clean PyPI install for Mnemo users.

If you're using a standalone LightRAG server (not Mnemo), the upstream package works fine — and you'll get upstream's updates faster.

Install

pip install mnemo-brain-mcp

After install the mnemo-brain-mcp command is on your PATH.

Configure

Point the bridge at your local LightRAG-API server (Mnemo runs it at 127.0.0.1:9621 by default):

Claude Code

Edit ~/.claude/claude_mcp_config.json (or run claude mcp add):

{
  "mcpServers": {
    "mnemo-brain": {
      "command": "mnemo-brain-mcp",
      "env": {
        "LIGHTRAG_BASE_URL": "http://localhost:9621",
        "LIGHTRAG_API_KEY": "<paste contents of secrets/lightrag_api_key.txt>"
      }
    }
  }
}

Restart Claude Code. Try:

"What does my brain know about my current projects?"

Cursor

Settings → MCP → Add new MCP server. Same JSON shape as above.

Cline / Windsurf

See their docs for the mcpServers config location — the JSON shape is the same.

What this gives you

22 tools over MCP, including:

Tool Purpose
query_text / query_text_stream Hybrid semantic + graph search
get_knowledge_graph Subgraph around a label
get_graph_labels All entity labels
check_entity_exists Quick existence probe
get_documents List indexed sources
get_health Server health
insert_text / update_entity / delete_document / ... Write operations (be careful — see below)

For the full tool list see the upstream docs in the archive/ directory.

Security note

This bridge exposes write tools (insert_text, update_entity, delete_document, ...). Granting your coding tool access to this MCP server grants it write access to the LightRAG knowledge graph.

For Mnemo specifically: the canonical writer to your Obsidian vault is the Telegram bot. Anything an MCP client insert_text's into the graph lives only in the LightRAG index, not in your Markdown notes. To write to your vault, message the bot.

Credit

Original code by @desimpkins. Renamed and republished with thanks. MIT-licensed both upstream and here.

License

MIT.

Metadata

Release files for mnemo-brain-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mnemo-brain-mcp 0.1.0
File Size Uploaded
mnemo_brain_mcp-0.1.0.tar.gz 43.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mnemo-brain-mcp 0.1.0
File Interpreter ABI Platform
mnemo_brain_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 70.2 kB

Release files / mnemo_brain_mcp-0.1.0.tar.gz

Download URL mnemo_brain_mcp-0.1.0.tar.gz
Size 43.0 kB
Tags Source
SHA-256 checksum
How to use checksums
41dc62b8e8bda01125c000f3d96c09bbcae757eb6e21e79efc51ab9da11d1cea
BLAKE2b-256 checksum
How to use checksums
69ed21c7d316eac311afa48eb94d253707ca003f9dbce30e4196ade49aadaeb3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release files / mnemo_brain_mcp-0.1.0-py3-none-any.whl

Download URL mnemo_brain_mcp-0.1.0-py3-none-any.whl
Size 27.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
361c5b3892f0beff36773c773d1982e8a2a918d77de239ef005aa55e8ee81480
BLAKE2b-256 checksum
How to use checksums
48cffda9d72f15cc9b4d09ec13d84231524375890b2389b2ffde037c1fdd008e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page