Which integrations are available for this server?

Indexes local Markdown folders as context sources, allowing retrieval of cited local notes. Indexes Obsidian vaults as context sources, allowing retrieval of cited notes from the vault.

How do I use litecontext-cli?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@litecontext-cli search my Obsidian notes for anything about MCP servers" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

LiteContext CLI

LiteContext CLI is a local-first context engine and MCP server for personal knowledge. It indexes local Markdown or Obsidian folders, preserves source citations, and lets compatible AI clients retrieve relevant local context through MCP.

It runs without a desktop application, browser, cloud account, or localhost UI. Your sources and indexes remain in ~/.litecontext by default.

Install

The Go engine is currently a read-only compatibility preview. It opens the existing LiteContext v1 JSON workspace, applies Context Profile boundaries, and provides cited search, doctor, and MCP stdio without Node at runtime:

go run ./cmd/litecontext doctor --workspace ~/.litecontext --json
go run ./cmd/litecontext search --workspace ~/.litecontext --query "project roadmap" --json
go run ./cmd/litecontext mcp serve --workspace ~/.litecontext

It does not yet write sources, profiles, or SQLite. The TypeScript CLI remains the compatibility baseline for those operations during migration. The first Go binary release will be distributed through GitHub Releases and Homebrew; npm is not a required product runtime.

Related MCP server: ragi

Current TypeScript CLI baseline

litecontext source add ~/Documents/notes --source-id notes --name "Personal notes"
litecontext source list
litecontext doctor
litecontext serve --mcp

For an Obsidian vault, add --source-type obsidian. source add creates a default Context Profile unless --no-default-profile is supplied. Use source sync <id> to refresh a source and source remove <id> to remove only LiteContext's local index and registry entries, never the original files.

MCP configuration

Print a pasteable configuration for an AI client:

litecontext mcp-config --global

The server command is litecontext serve --mcp. The MCP server reads the same local workspace when no desktop application is running.

Workspace and architecture

Local Markdown / Obsidian
  -> connectors and ContextItem normalization
  -> SQLite/FTS index + Context Profile
  -> LiteContext CLI / MCP stdio
  -> cited local context for an AI client

@litecontext/core — contracts, profiles, SQLite/FTS index, retrieval.
@litecontext/connectors — portable source connectors.
@litecontext/cli — source lifecycle commands, diagnostics, and MCP server.

Development

The transition repository currently verifies both the TypeScript baseline and the Go read-only engine. It requires Go 1.24.1, Node 24.13–24.x, and pnpm 10.

pnpm install
pnpm check
pnpm audit:security

pnpm check runs the shared golden fixture tests for both implementations.

See CONTRIBUTING.md, SECURITY.md, third-party notices, and the release guide.

License

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

trip2g B
io.github.trip2g
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
RAG Systems Note Taking Search
11238
saagarpatel.dev Portfolio A
io.github.saagpatel
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
Search Documentation Access
82
Mirror Memory MCP Server
io.github.Tr1ckyMag1ca1
Personal knowledge base MCP server with semantic search, auto-categorization, metadata extraction
Knowledge & Memory Search Note Taking
2
mcp A
ai.llmse
Public MCP server for the LLM Search Engine
Search RAG Systems Developer Tools
102

Related MCP Servers

memory-mcp
Knowledge & Memory RAG Systems Search
Shaktisinhchavda
A
license
A
quality
D
maintenance
A local-first MCP server that exposes personal notes and files as unified semantic context for AI agents via vector search and file monitoring.
Updated 4 months ago (2026-05-18 05:14 UTC)
6
MIT
ragi
RAG Systems Search
SusuTawar
A
license
A
quality
D
maintenance
Local-first RAG indexing and semantic search MCP server. Enables document retrieval and context-aware queries using local embedding models.
Updated a month ago (2026-08-13 16:07 UTC)
3
6
MIT
context-hub-mcp
Knowledge & Memory Developer Tools Documentation Access
Nuttapon
A
license
Not graded
quality
D
maintenance
A local-first MCP server that turns a .context/ folder of markdown files into a searchable knowledge layer for AI coding agents.
Updated 6 months ago (2026-03-28 05:44 UTC)
12
2
MIT
ragmark
RAG Systems Knowledge & Memory Note Taking
cdcoonce
A
license
Not graded
quality
A
maintenance
Local-first MCP server for retrieval over markdown wikilink vaults, offering hybrid vector+lexical search, note reading, neighbor expansion, and recent activity tracking with fully local embeddings and no network egress.
Updated a month ago (2026-08-09 16:37 UTC)
MIT