Kybase
io.github.Kyrzin/kybase
About Kybase
Kybase is an MCP server published by the GitHub account Kyrzin. Self-hosted Markdown memory for AI agents: notes you can read and edit, with hybrid search.
It runs on your own machine: your AI client starts it from the npm package kybase-mcp at version 0.2.3.
It asks for 3 secrets: GOOGLE_API_KEY, OPENAI_API_KEY and DATABASE_URL. Give it a key with the least access that still works.
Version 0.2.3 was published on 22 October 2026, and the source code is public, so you can read it before installing.
Written from the registry entry. 9 automated checks on the registry entry and the package code: 6 pass, 2 warn, 0 fail, 1 info. How we check.
What it asks for
| Variable | Required | Secret | Description |
|---|---|---|---|
KYBASE_DATA_DIR | No | No | Where the embedded database and instance secret live. Defaults to ~/.kybase |
EMBEDDING_PROVIDER | No | No | Embedding provider for semantic search |
OLLAMA_URL | No | No | Ollama endpoint for local embeddings. Without any provider, full-text search still works |
OLLAMA_MODEL | No | No | Ollama embedding model |
GOOGLE_API_KEY | No | Yes | Google API key, when EMBEDDING_PROVIDER=google. Sends note text to Google |
OPENAI_API_KEY | No | Yes | OpenAI API key, when EMBEDDING_PROVIDER=openai. Sends note text to OpenAI |
DATABASE_URL | No | Yes | Use an existing Kybase Postgres instead of the embedded one (migrations are left to the app) |
Checks
| Check | Result | Detail |
|---|---|---|
| Source repository linked | Pass | https://github.com/Kyrzin/kybase |
| Version pinned | Pass | Every package has an explicit version |
| Secrets requested | Warn | Asks for 3 secrets: GOOGLE_API_KEY, OPENAI_API_KEY, DATABASE_URL |
| Known package registry | Pass | All packages come from npm, PyPI, OCI, NuGet or MCPB |
| Namespace ownership | Info | Name verified via GitHub account Kyrzin |
| Registry text aimed at the AI | Pass | Description and settings contain no hidden characters or instructions to the AI |
| Install scripts | Warn | Runs at install: prepare: node build.mjs |
| Code red flags | Pass | Read 3 files in kybase-mcp@0.2.3: no obfuscation, encoded execution, credential reads or data-collection endpoints found |
| Text aimed at the AI | Pass | No hidden characters or instructions to the AI in 3 files, including comments and the README |
Popularity & health: 48 / 100
Worked out from public numbers and our own checks, not from user reviews or ratings. It says how used and how looked-after a server is, not whether it is safe.
0 forks, 41 merged pull requests. Sources: GitHub, npm, PyPI (pypistats.org) and Hacker News (Algolia), fetched 2026-10-31.
What people say
No Hacker News threads link to its source code.
Look further: search Reddit, search Hacker News, read its GitHub issues. These are not reviews we checked.
Facts
| Registry name | io.github.Kyrzin/kybase |
|---|---|
| Publisher | GitHub account Kyrzin |
| How the name is verified | Name verified via GitHub account Kyrzin. The registry ties the name prefix to that account or domain; it does not check the code. |
| Type | Local: runs on your machine from a package |
| Packages | npm kybase-mcp 0.2.3 (stdio) |
| Version | 0.2.3 |
| Published | |
| Last updated | |
| Source repository | https://github.com/Kyrzin/kybase |
| Website | https://kyrzin.github.io/kybase/ |
| Category | Files & documents (assigned by keyword rule, not by hand) |
Related servers in Files & documents
- trip2g4/4Serve a folder of Markdown notes as an MCP server: hybrid search,…
- Vault Cortex4/4Standalone MCP server for Obsidian vaults — hybrid search, notes &…
- loci7/7Cross-session memory and hybrid RAG over your notes and docs.…
- Postgram4/5Self-hosted memory for AI agents with hybrid search, knowledge…
- Exomem7/7Local Markdown/Obsidian knowledge substrate for MCP agents with…
- memtomem6/7Markdown-first long-term memory for AI agents. Hybrid BM25 + vector…