Self-hosted Markdown memory for AI agents: notes you can read and edit, with hybrid search.
Connect Runs on your machine
claude mcp add kybase -e KYBASE_DATA_DIR=<KYBASE_DATA_DIR> -e EMBEDDING_PROVIDER=<EMBEDDING_PROVIDER> -e OLLAMA_URL=<OLLAMA_URL> -e OLLAMA_MODEL=<OLLAMA_MODEL> -e GOOGLE_API_KEY=<GOOGLE_API_KEY> -e OPENAI_API_KEY=<OPENAI_API_KEY> -e DATABASE_URL=<DATABASE_URL> -- npx -y [email protected]{
"mcpServers": {
"kybase": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"KYBASE_DATA_DIR": "<KYBASE_DATA_DIR>",
"EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>",
"OLLAMA_URL": "<OLLAMA_URL>",
"OLLAMA_MODEL": "<OLLAMA_MODEL>",
"GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}{
"mcpServers": {
"kybase": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"KYBASE_DATA_DIR": "<KYBASE_DATA_DIR>",
"EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>",
"OLLAMA_URL": "<OLLAMA_URL>",
"OLLAMA_MODEL": "<OLLAMA_MODEL>",
"GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}{
"servers": {
"kybase": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"KYBASE_DATA_DIR": "<KYBASE_DATA_DIR>",
"EMBEDDING_PROVIDER": "<EMBEDDING_PROVIDER>",
"OLLAMA_URL": "<OLLAMA_URL>",
"OLLAMA_MODEL": "<OLLAMA_MODEL>",
"GOOGLE_API_KEY": "<GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"DATABASE_URL": "<DATABASE_URL>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
KYBASE_DATA_DIROptional | Where the embedded database and instance secret live. Defaults to ~/.kybase |
EMBEDDING_PROVIDEROptional | Embedding provider for semantic search |
OLLAMA_URLOptional | Ollama endpoint for local embeddings. Without any provider, full-text search still works |
OLLAMA_MODELOptional | Ollama embedding model |
GOOGLE_API_KEYOptional, secret | Google API key, when EMBEDDING_PROVIDER=google. Sends note text to Google |
OPENAI_API_KEYOptional, secret | OpenAI API key, when EMBEDDING_PROVIDER=openai. Sends note text to OpenAI |
DATABASE_URLOptional, secret | Use an existing Kybase Postgres instead of the embedded one (migrations are left to the app) |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 29 Oct 2026 |
| Last updated | 29 Oct 2026 |
| Registry name | io.github.Kyrzin/kybase |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.