
zen
by sheshbabu·★ 1,085·Score 53
Selfhosted notes app with MCP integration for searching, listing and reading notes.
Overview
Zen is a self-hosted notes application built as a single Go binary with notes stored as markdown in SQLite. It offers full-text search with BM25 ranking, flexible tagging instead of rigid folders, and various markdown features. The application includes experimental MCP functionality that allows searching, listing, and reading notes through the Model Context Protocol. It's designed for low resource usage while maintaining feature-rich note-taking capabilities.
Try asking AI
After installing, here are 5 things you can ask your AI assistant:
When to choose this
Choose Zen if you need a lightweight, self-hosted note-taking solution with markdown support and experimental MCP integration.
When NOT to choose this
Don't choose this if you're looking for a dedicated MCP server implementation rather than a notes application with MCP features.
Tools this server exposes
3 tools extracted from the READMEsearch_notessearch_notes(query: string) -> []NoteSearch notes using full-text search with BM25 ranking
list_noteslist_notes(tags?: string[], archived?: boolean) -> []NoteList all notes with optional filtering by tags and archive status
read_noteread_note(id: string) -> NoteRead the content of a specific note by ID
Comparable tools
Installation
Installation
Build from source
$ make buildLocal Development
Run the application using default configuration
$ make devMCP Configuration
Add to Claude Desktop config.json:
{
"mcpServers": {
"zen": {
"command": "path-to-zen-executable",
"args": ["--mcp"]
}
}
}FAQ
- What MCP operations does Zen provide?
- Zen provides MCP functionality for searching, listing, and reading notes through the Model Context Protocol.
- How resource-efficient is Zen?
- Zen is designed for very low resource usage, making it suitable for running on modest hardware or in constrained environments.
On Hacker News
Recent discussion from the developer community.
- Story by rkwz · 2025-09-23
Compare zen with
Last updated · Auto-generated from public README + GitHub signals.